Transports
Events MCP tools
The 6 tools /mcp offers for Events, what each needs and an example call.
Webhook endpoints, inboxes, event types and delivery statistics. These are the 6 tools of the events backend; all MCP tools lists the other backends.
events_get_delivery_stats
Get delivery stats. Send a delivery again now, whatever its state; the event id stays the same. How the account's webhook deliveries went over the last 24 hours, 7 or 30 days, for every endpoint or one: finished deliveries per hour (24 h) or UTC day, succeeded and failed, the endpoint's answer time (p50, p95), the failures grouped by error and HTTP status, and counts per event type.
Scopes: mcp:read, webhooks:read · reads only
| Argument | Type | What it is |
|---|---|---|
account_id | string | The account; empty is the caller's own. |
endpoint_id | string | One endpoint of the account; empty for all of them. |
range | string | "24h", "7d" (the default) or "30d". |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "events_get_delivery_stats",
"arguments": {}
}
}events_get_endpoint
Get endpoint. One endpoint.
Scopes: mcp:read, webhooks:read · reads only
| Argument | Type | What it is |
|---|---|---|
endpoint_id | string |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "events_get_endpoint",
"arguments": {}
}
}events_get_event_stats
Get event stats. The account's webhook endpoints. Published events per UTC day and type over the last 7 or 30 days (what happened on the account, whether or not an endpoint took it).
Scopes: mcp:read, events:read · reads only
| Argument | Type | What it is |
|---|---|---|
account_id | string | The account; empty is the caller's own. |
range | string | "7d" or "30d" (the default). |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "events_get_event_stats",
"arguments": {}
}
}events_list_endpoints
List endpoints. Calls iohr.events.v1.EventsService/ListEndpoints.
Scopes: mcp:read, webhooks:read · reads only
| Argument | Type | What it is |
|---|---|---|
account_id | string | The account; empty is the caller's own. |
page_size | integer | At most 200 (larger is coerced down); 0 means 50. |
page_token | string | From the previous answer's next_page_token; "" for the first page. A token from another account's list is INVALID_ARGUMENT. |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "events_list_endpoints",
"arguments": {}
}
}events_list_event_types
List event types. The event catalogue: every type, what it means and its JSON Schema.
Scopes: mcp:read, events:read · reads only
| Argument | Type | What it is |
|---|---|---|
page_size | integer | At most 200 (larger is coerced down); 0 means 50. |
page_token | string | From the previous answer's next_page_token; "" for the first page. |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "events_list_event_types",
"arguments": {}
}
}events_list_inboxes
List inboxes. The account's test inbox, when it has one that has not expired: an address that receives webhooks without a server of your own.
Scopes: mcp:read, webhooks:read · reads only
| Argument | Type | What it is |
|---|---|---|
account_id | string | The account; empty is the caller's own. |
page_size | integer | At most 200 (larger is coerced down); 0 means 50. |
page_token | string | From the previous answer's next_page_token; "" for the first page. |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "events_list_inboxes",
"arguments": {}
}
}