The Blackfire MCP server

Blackfire provides a local MCP (Model Context Protocol) via the CLI command blackfire mcp.

1
claude mcp add blackfire -- blackfire mcp

Claude Code runs everything after --. Add --scope user to make the Blackfire MCP available in all your projects, or --scope project to write it to a .mcp.json file you commit for your team:

1
claude mcp add --scope user blackfire -- blackfire mcp
1
codex mcp add blackfire -- blackfire mcp

To edit the configuration file instead, add the following to ~/.codex/config.toml:

1
2
3
[mcp_servers.blackfire]
command = "blackfire"
args = ["mcp"]

Run /mcp in a Codex session to check that the tools are listed.

Declare the server in the mcp block of opencode.json, in your project root, or in ~/.config/opencode/opencode.json for every project:

1
2
3
4
5
6
7
8
9
10
{
    "$schema": "https://opencode.ai/config.json",
    "mcp": {
        "blackfire": {
            "type": "local",
            "command": ["blackfire", "mcp"],
            "enabled": true
        }
    }
}

Pi reaches MCP servers through the pi-mcp-adapter package:

1
pi install npm:pi-mcp-adapter

Restart Pi, then declare the server in ~/.pi/agent/mcp.json, or in a .mcp.json file at your project root:

1
2
3
4
5
6
7
8
{
    "mcpServers": {
        "blackfire": {
            "command": "blackfire",
            "args": ["mcp"]
        }
    }
}