subscriptions.list · Cortex MCP Docs

Description

Per ADR-0021 §subscriptions.

Input schema

Field	Type	Required	Description
`active_only`	`boolean`	no	Default true.

Output shape

typescript

{ items: Array<{ subscription_id: string; action_class: string; counterparty_filter?: object; mode_filter?: string[]; expires_at?: string; created_at: string }> }

Example call

JSON-RPC tools/call request body (omit the JSON-RPC envelope when using an SDK; the SDK adds it for you):

jsontools/call params

{ "name": "subscriptions.list", "arguments": { "active_only": true } }

Example response

Tool results are always wrapped as content[0].text with a stringified JSON body. The shape below is what you get back from JSON.parse(result.content[0].text):

jsonparsed result body

{ "items": [{ "subscription_id": "sub_01H...", "action_class": "communicate", "counterparty_filter": { "classification": "colleague" }, "mode_filter": ["ask"], "created_at": "2026-06-15T10:00:00Z" }] }

Errors this tool can return

Code	Meaning
`invalid_arguments`	Tool input failed Zod validation.
`unauthorized`	Missing or invalid bearer token.
`quota_exceeded`	Per-minute, daily call, or daily inference budget exceeded.

See the full error catalog for resolution steps on each code, plus the standard transport-layer responses (401, 429).