MCP tools

The Firedrill MCP server at https://mcp.firedrill.run lets your coding agent manage Firedrill from the chat. It saves resources, prepares worlds, starts synthetic tools and reads reports. It works on the same account and workspaces as the CLI and the web app.

Tools

Call firedrill_workspaces first. Most other tools need a workspace_id.

Tool	What it does
`firedrill_workspaces`	Lists the workspaces this connection can use.
`firedrill_register_agent`	Registers a local agent from a descriptor. Records metadata only.
`firedrill_save_resource`	Saves a persona, scenario or evaluation, or forks an existing version.
`firedrill_create_world`	Saves a world for a registered agent. Nothing starts.
`firedrill_review_world`	Creates a plan review for one world revision. Nothing starts.
`firedrill_prepare_world`	Approves a plan review and its credit budget, then prepares the world.
`firedrill_create_campaign`	Creates a campaign from a prepared world and allocates its drills.
`firedrill_report`	Reads a campaign’s progress.
`firedrill_review_tools`	Reviews a set of synthetic tools to start on their own.
`firedrill_quote_tools`	Returns the credit estimate for a reviewed tool set.
`firedrill_start_tools`	Starts a reviewed tool set after approval.
`firedrill_inspect_tool`	Reads one synthetic tool instance. Never returns credentials.
`firedrill_discover`	Searches the full list of operations, or returns one operation’s input schema.
`firedrill_operation`	Runs an operation found with `firedrill_discover`.

Use firedrill_discover for anything without its own tool, such as reading drill results, checking a request after a timeout, or cancelling work.

Inputs

Most tools take the same shape:

{
  "path": { "workspace_id": "<workspace-id>" },
  "query": {},
  "headers": { "Idempotency-Key": "<uuid>" },
  "body": {}
}

Write tools need a request key, either request_key in the body or an Idempotency-Key header. Send the same key again if a call times out. Firedrill applies the change once. A read-only connection only sees read tools.

What the MCP server cannot do

Read files on your machine or start processes. Use the CLI to run drills, enroll a runner and give a local agent access to synthetic tools.
Upload a custom tool package. Use firedrill tools push.
Manage your team, billing, settings or vault. Use the web app.
Approve spending for you. Your coding agent should show you the estimate and wait for your answer.

Connection details

Setting	Value
URL	`https://mcp.firedrill.run`
Transport	Streamable HTTP, one JSON response per request
Authentication	OAuth authorization code with PKCE, started by your MCP client
Protocol versions	`2025-11-25`, `2025-06-18`, `2025-03-26`

Send the access token in the Authorization header only. Tokens in URLs and browser cookies are refused.

Set up your coding agent

Connect your client.

Prompts for coding agents

Copyable prompts for each task.

Get started

Coding agents

Connect your agent

Build a world

Run drills

Read results

Account

Reference