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"]
}
}
}