MCP Tools

Klaxon exposes 8 MCP tools via JSON-RPC 2.0 at POST /mcp. Agents authenticate with an API key bearer token.

Plan limits

klaxon.notify and klaxon.ask consume the org's monthly_notifications plan quota. When the quota is exhausted, the JSON-RPC response carries an error with code: -32002 and a payload describing which limit was hit — see Billing → Plan-limit gate.

Protocol

• MCP version: 2025-03-26
• JSON-RPC: 2.0
• Endpoint: POST /mcp

Request format

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "klaxon.notify",
    "arguments": { "title": "Hello" }
  }
}

Response format

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{ "type": "text", "text": "{\"id\":\"...\",\"status\":\"created\"}" }]
  }
}

Per the MCP spec, only content[*] is forwarded to the LLM. The structured payload is JSON inside content[0].text.

Available Tools

klaxon.notify

Send a notification to the user.

Param	Type	Required	Description
title	string	Yes	Notification title
message	string	No	Body text
level	string	No	info / warning / error / success (default: info)
channel	string	No	Channel name
tags	string[]	No	Tags
priority	int	No	0-4
metadata	object	No	Key/value annotations

klaxon.ask

Ask the user a question via a form.

Param	Type	Required	Description
title	string	Yes	Question title
form	object	Yes	Form schema (see Items & Forms)
message	string	No	Additional context
level	string	No	Alert level
channel	string	No	Channel name
tags	string[]	No	Tags
priority	int	No	Priority

klaxon.list

List klaxon items.

Param	Type	Required	Description
status	string	No	Filter by status
channel	string	No	Filter by channel name
limit	int	No	Max results (default: 50, max: 200)
include_archived	bool	No	Include archived items
include_snoozed	bool	No	Include snoozed items

klaxon.ack

Acknowledge an item (mark as viewed).

Param	Type	Required
id	string (UUID)	Yes

klaxon.dismiss

Dismiss an item.

Param	Type	Required
id	string (UUID)	Yes

klaxon.snooze

Snooze an item until a specific time.

Param	Type	Required	Description
id	string (UUID)	Yes	Item ID
until	string (datetime)	Yes	ISO 8601 datetime

klaxon.comment_add

Add a comment to an item.

Param	Type	Required
id	string (UUID)	Yes
text	string	Yes

klaxon.update

Update item fields.

Param	Type	Required	Description
id	string (UUID)	Yes	Item ID
title	string	No	New title
message	string	No	New message
level	string	No	New level
priority	int	No	New priority
tags	string[]	No	Replace tags
metadata	object	No	Replace metadata

Protocol Methods

Method	Description
initialize	Returns server info + capabilities
tools/list	Returns all tool definitions with input schemas
tools/call	Execute a tool