Start free →

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.

All of the API reference

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:read
Parameters
days

/api/v1/mcp

GET /api/v1/mcp

Not used — the MCP gateway opens no stream (405)

Authentication
API key
Key scope
agents:write
Module
Served where the deployment runs FEATURE_MCP_GATEWAY.
Answers
405

POST /api/v1/mcp

The governed MCP gateway (Streamable HTTP, tools only)

Authentication
API key
Key scope
agents:write
Module
Served where the deployment runs FEATURE_MCP_GATEWAY.
Body
application/json

DELETE /api/v1/mcp

Not used — the MCP gateway keeps no session (405)

Authentication
API key
Key scope
agents:write
Module
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:read
Module
Served where the deployment runs FEATURE_ASSISTANT.
Parameters
tool (required)
Body
input · locale