agent.feature_flags

Live

Return the public subset of operator-controlled flags affecting MCP client behavior.

CategoryAgent
JSON-RPCtools/call
EndpointPOST /mcp
Sourcepackages/mcp-tools/src/tools/agent-feature-flags.ts

Description

Only flags affecting MCP client behavior are exposed (e.g., trigger_dispatch_enabled, substrate_read_api_enabled, subscriptions_polled_vs_event_hooked). Internal operational flags are NOT exposed. Per ADR-0021 §capabilities.

Input schema

This tool takes no arguments.

Output shape

typescript
{ flags: Record<string, boolean> }

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": "agent.feature_flags", "arguments": {} }

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
{
  "flags": {
    "trigger_dispatch_enabled": true,
    "substrate_read_api_enabled": true,
    "subscriptions_polled_vs_event_hooked": false
  }
}

Errors this tool can return

CodeMeaning
unauthorizedMissing or invalid bearer token.

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