install-mcp
Install panda MCP Server
Register panda as an MCP server in the user's AI coding assistants. Panda
exposes an SSE transport at http://localhost:2480/sse by default.
Steps
- Detect which clients are installed by checking for their config directories.
- For each detected client, read the existing config file (or start with
{}). - Merge the
mcpServers.pandaentry — preserve all existing keys. - Write the updated config back.
- Report what was configured.
Client Configurations
Claude Code
- Detection:
~/.claude/directory exists - Config file:
~/.claude.json - Entry to merge into
mcpServers:
{
"panda": {
"type": "sse",
"url": "http://localhost:2480/sse"
}
}
Claude Desktop (macOS)
- Detection:
~/Library/Application Support/Claude/directory exists - Config file:
~/Library/Application Support/Claude/claude_desktop_config.json - Entry to merge into
mcpServers:
{
"panda": {
"url": "http://localhost:2480/sse"
}
}
Cursor
- Detection:
~/.cursor/directory exists - Config file:
~/.cursor/mcp.json - Entry to merge into
mcpServers:
{
"panda": {
"url": "http://localhost:2480/sse"
}
}
Rules
- Read the full config file before writing. Never overwrite — always merge.
- If
mcpServersdoes not exist in the config, create it. - If
pandais already registered, tell the user and skip unless they ask to overwrite. - Use 2-space JSON indentation with a trailing newline.
- If no supported clients are detected, tell the user and list the supported clients.
More from ethpandaops/panda
query
Query Ethereum network data via ethpandaops CLI or MCP server. Use when analyzing blockchain data, block timing, attestations, validator performance, network health, or infrastructure metrics. Provides access to ClickHouse (blockchain data), Prometheus (metrics), Loki (logs), and Dora (explorer APIs).
5investigate
Debug Ethereum devnet or network issues. Use when diagnosing finality delays, network splits, offline nodes, client bugs, or general network health problems. Works for both local Kurtosis devnets and remote hosted deployments.
4self-play
Run schema probing self-play loop to find and fix ClickHouse schema ambiguity in the panda repo. Use when the user wants to improve query reliability by finding where the agent picks different tables for the same question.
3install-panda
>-
2create-runbook
Extract a reusable runbook from a successful investigation or troubleshooting session. Use after completing a multi-step diagnosis that could help future investigations.
1create-module
Add a new datasource module to ethpandaops/panda. Triggers on: add module, new module, create module, add plugin, new plugin, create plugin, add datasource.
1