MCP tools reference

stromboli serves these tools to MCP clients, over stdio with stromboli mcp or over streamable HTTP at /mcp with STROMBOLI_MCP_ENABLED=true. They call the same services as the API. The definitions are pinned in internal/mcpserver/testdata/tools.golden.json.

Tool Arguments (required) Read-only
list_services yes
get_service name yes
get_brief service, since (duration, default 1h, max 168h) yes
list_investigations service, status (running, completed, failed), limit (default 10, max 50) yes
get_investigation id, include_steps (bool), after_seq (with include_steps) yes
wait_investigation id, until (mitigation default, or finished), timeout_s (default 60, max 300) yes
start_investigation service, title (default Investigation of <service>), description no
list_actions investigation_id, status, limit (default 20, max 50) yes
get_action id yes

Tools

list_services: every catalog service with its tier, owners and direct dependencies.

get_service: a service’s catalog entry (owners, runtime, where its logs, metrics and deploys live, runbooks) and the services upstream and downstream of it.

get_brief: the brief, built without the LLM. Free.

list_investigations: recent investigations, newest first.

get_investigation: status, the mitigation proposed first, and the report once finished. With include_steps, the audit trail, paged with after_seq.

wait_investigation: waits until the mitigation is published (until=mitigation) or the investigation finished (until=finished), for at most timeout_s, sending progress notifications as steps happen. Returns what get_investigation returns; call it again if still running.

start_investigation: starts an investigation and returns its ID right away. It spends LLM tokens and posts to Slack, but only reads from production. The investigation’s source is mcp and its alert holds the client’s name (mcp_client).

list_actions, get_action: proposed machine actions, their status, who decided them and their result. Approving needs a named human, in the CLI or Slack.

Authentication

Transport Credential
stdio (stromboli mcp) the CLI’s STROMBOLI_API_TOKEN (or --token-file), sent to --url
HTTP (/mcp) Authorization: Bearer <token>: STROMBOLI_MCP_TOKEN when set (it reaches only these tools), else STROMBOLI_API_TOKEN

STROMBOLI_MCP_ENABLED=true requires STROMBOLI_API_TOKEN: the endpoint is never served unauthenticated.

Edit this page on GitHub ↗