action_classes.list · Cortex MCP Docs

Description

Returns payload schema, action_class_version (schema hash), and trust_pair_count. Per ADR-0022.

Input schema

Field	Type	Required	Description
`scope`	`'tenant' \| 'client'`	no	Default 'tenant'.
`active_only`	`boolean`	no	Default true.

Output shape

typescript

{ items: Array<{ class_id: string; namespaced_name: string; namespace: string; name: string; client_id: string; payload_schema: object; allowed_modes: string[]; action_class_version: string; trust_pair_count: number; registered_at: string; deregistered_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": "action_classes.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": [{ "class_id": "550e8400-e29b-41d4-a716-446655440000", "namespaced_name": "acme_builder.transact", "namespace": "acme_builder", "name": "transact", "client_id": "acme_builder", "payload_schema": { "type": "object" }, "allowed_modes": ["ask"], "action_class_version": "abc123def456", "trust_pair_count": 0, "registered_at": "2026-05-30T12:00:00.000Z", "legal_effect_classification": "possible" }] }

Errors this tool can return

Code	Meaning
`invalid_arguments`	Tool input failed Zod validation.
`unauthorized`	Missing or invalid bearer token.

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