Sign in
Docs
0%

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

ArgumentTypeWhat it is
account_idstringThe account the thing belongs to; empty for the caller's own.
channelstring
channel_paramstring
channel_refstring
eventsstringEmpty means all.
target_idstring
target_kindstring
{
  "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

ArgumentTypeWhat it is
subscription_idstring
{
  "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

ArgumentTypeWhat it is
account_idstringThe account's id; empty is the caller's own.
page_sizeinteger
page_tokenstringThe 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

ArgumentTypeWhat it is
eventsstringEmpty keeps it.
muted_untilstringRFC 3339 to mute until; "never" unmutes; empty keeps it.
subscription_idstring
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "subscriptions_update",
    "arguments": {}
  }
}