Set up your coding agent

Your coding agent uses three things. Each is set up separately, and setting up one does not set up the others.

Part	What it gives your coding agent	Needed for
MCP server	Firedrill tools inside the chat: workspaces, agents, worlds, reports	Saving resources and reading results
Skill	Instructions for the full Firedrill workflow	Fewer mistakes and fewer questions
CLI	The `firedrill` command	Running drills on your machine

The MCP server cannot read your files or start processes. Running a drill always needs the CLI.

Add the MCP server

The server address is https://mcp.firedrill.run. It uses Streamable HTTP and signs you in through your browser. You do not need an API key.

Claude Code
Codex
Cursor and VS Code
Other clients

claude mcp add --transport http firedrill https://mcp.firedrill.run

Run /mcp in Claude Code, select firedrill and sign in. Add --scope user to use it in every project, or --scope project to share it with your team through .mcp.json.

codex mcp add firedrill --url https://mcp.firedrill.run
codex mcp login firedrill

The login command opens your browser. To remove the server later, run codex mcp remove firedrill.

Add a remote MCP server with these settings:

Name: firedrill
Transport: Streamable HTTP
URL: https://mcp.firedrill.run
Authentication: OAuth in the browser

Your client finds the sign-in page by itself. Do not paste a token into the configuration.

Each MCP connection belongs to one Firedrill organization. To use a different organization, remove the server and connect again. You can see and revoke connections in the web app under Settings → Account → Access. firedrill mcp prints these setup commands for your client. It never edits your configuration.

Install the skill

The skill teaches your coding agent the Firedrill workflow, the file formats and when to stop and ask you.

npx skills add firedrill-tools/firedrill-skills

The skill installs into the current project by default. Add -g to install it for your user, or -a claude-code or -a codex to target one client. Update it with npx skills update firedrill.

Install the CLI

The CLI needs Node.js 22.23.4 or a later 22.x release, 24.11.1 or a later 24.x release, or 26.13.1 or a later 26.x release. Other versions, including 23 and 25, are not supported.

npm install --global firedrill-run
firedrill init

firedrill init signs you in through the browser, selects your workspace and checks this machine. It uploads nothing and calls no model. To use it without a global install, run npx firedrill-run init. npx does not install a global firedrill command, so keep the prefix on every later command: npx firedrill-run status. The firedrill commands in these docs need the global install above. Signing in to the CLI and signing in to the MCP server are separate. Use the same organization for both.

Check it works

Paste this prompt. It only reads.

Use Firedrill. List my workspaces, run `firedrill status --json` and tell me which
workspace, credential store and drivers are available. Do not create anything.

First prompt

Use Firedrill to simulate and evaluate the agent in this repository. Read the code first. Tell me how
it starts, how users talk to it, which APIs and MCP servers it calls and what state
it keeps. Then propose a descriptor, a local plan and one scenario. Do not register
or save anything until I approve.

More prompts are in Prompts for coding agents.

What only you can do

Your coding agent prepares everything. A person must still:

Sign in to the CLI and the MCP server in the browser.
Approve the plan review before firedrill apply, which reserves credits.
Approve the commands firedrill run will start on your machine.
Approve reassessments and synthetic tool sessions that use credits.
Invite teammates, change roles and manage billing in the web app.

When the CLI runs with --json, it never prompts. Your coding agent must pass an approval flag such as --approve, and it should only do that after you said yes. See Agent mode.

Troubleshooting

The firedrill tools do not appear

Restart your coding agent after adding the server. In Claude Code, run /mcp and check that firedrill is connected and signed in.

The MCP server says no workspace is available

Create or choose a workspace in the web app at app.firedrill.run, then ask your coding agent to list workspaces again.

The coding agent says it cannot run a drill

That is expected over MCP. Install the CLI and run firedrill run in a terminal on your machine.

MCP tools

Every tool the server offers.

Run the quickstart

Your first drill, end to end.

Get started

Coding agents

Connect your agent

Build a world

Run drills

Read results

Account

Reference