Transports
Subscriptions MCP tools
The 4 tools /mcp offers for Subscriptions, what each needs and an example call.
Follow something and get told when it changes: create, list, update and stop. These are the 4 tools of the subscriptions backend; all MCP tools lists the other backends.
subscriptions_create
Follow something. Follow a thing in an account (target_kind account, incident, monitor, agent, document, space or connection; target_id its id, empty for the whole account) and hear about it: events all, state (opened, resolved, down, recovered, decided) or urgent; channel email (your own address), chat (channel_ref a Slack, Discord or Teams connection already granted to Signals for post_message, channel_param the chat channel's id) or webhook (channel_ref an endpoint the account already has; owners and admins). An empty account_id is your own. You follow only what you can see.
Scopes: mcp:write · changes something · safe to repeat
| Argument | Type | What it is |
|---|---|---|
account_id | string | The account the thing belongs to; empty for the caller's own. |
channel | string | |
channel_param | string | |
channel_ref | string | |
events | string | Empty means all. |
target_id | string | |
target_kind | string |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "subscriptions_create",
"arguments": {}
}
}subscriptions_delete
Stop following. Stop following.
Scopes: mcp:write · changes something · may overwrite or remove · safe to repeat
| Argument | Type | What it is |
|---|---|---|
subscription_id | string |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "subscriptions_delete",
"arguments": {}
}
}subscriptions_list
List what I follow. The caller's own subscriptions, newest first; with account_id, only that account's. 0 means 50, at most 200.
Scopes: mcp:read · reads only
| Argument | Type | What it is |
|---|---|---|
account_id | string | The account's id; empty is the caller's own. |
page_size | integer | |
page_token | string | The next_page_token of the page before. |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "subscriptions_list",
"arguments": {}
}
}subscriptions_update
Change or mute a subscription. Change which events a subscription takes (all, state or urgent), or mute it until a time (RFC 3339; never unmutes).
Scopes: mcp:write · changes something · safe to repeat
| Argument | Type | What it is |
|---|---|---|
events | string | Empty keeps it. |
muted_until | string | RFC 3339 to mute until; "never" unmutes; empty keeps it. |
subscription_id | string |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "subscriptions_update",
"arguments": {}
}
}