> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firedrill.run/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP tools

> Every tool the Firedrill MCP server offers, what it does and what it cannot do.

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:

```json theme={null}
{
  "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.

> [card] [Set up your coding agent](https://docs.firedrill.run/agents/setup.md)
>
> Connect your client.

> [card] [Prompts for coding agents](https://docs.firedrill.run/agents/prompts.md)
>
> Copyable prompts for each task.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.