API reference
Agents and MCP
Read spend and savings per agent, call tools through the governed MCP gateway, and run the assistant’s read tools.
Route summaries and field names are written in English, here and in the file.
/api/v1/agents
GET /api/v1/agents
Spend and savings per agent
Authentication
API key
Key scope
agents:readParameters
daysAnswers
200 · 400 validation_failed · 401 api_key_missing, api_key_invalid · 403 api_key_scope_denied, api_key_role_denied, ip_not_allowed, plan_required · 429/api/v1/mcp
GET /api/v1/mcp
Not used — the MCP gateway opens no stream (405)
Authentication
API key
Key scope
agents:writeModule
Served where the deployment runs
FEATURE_MCP_GATEWAY.Answers
405POST /api/v1/mcp
The governed MCP gateway (Streamable HTTP, tools only)
Authentication
API key
Key scope
agents:writeModule
Served where the deployment runs
FEATURE_MCP_GATEWAY.Body
application/jsonAnswers
200 · 202 · 400 · 401 api_key_missing, api_key_invalid · 403 key_not_bound_to_agent, origin_not_allowed, api_key_scope_denied, plan_required · 429 · 500 internal_error · 501 feature_disabled · 503 feature_disabled, service_unavailableDELETE /api/v1/mcp
Not used — the MCP gateway keeps no session (405)
Authentication
API key
Key scope
agents:writeModule
Served where the deployment runs
FEATURE_MCP_GATEWAY.Answers
405/api/v1/insights
POST /api/v1/insights/{tool}
Run one of the assistant's read tools
Authentication
API key
Key scope
insights:readModule
Served where the deployment runs
FEATURE_ASSISTANT.Parameters
tool (required)Body
input · localeAnswers
200 · 400 validation_failed · 401 api_key_missing, api_key_invalid · 403 assistant_disabled, api_key_scope_denied, plan_required · 404 unknown_tool · 429 · 500 internal_error · 501 feature_disabled · 503 service_unavailable