Superlog — Claude Code MCP server: logs, traces, incidents
Hooks your coding agent up to application telemetry, so it can pull logs, traces, metrics and incidents on its own while you debug production.
claude mcp add --transport http superlog https://api.superlog.sh/mcpWhat Superlog does
Superlog is an open-source telemetry system built around OpenTelemetry. It takes in traces, logs and metrics, folds scattered signals into incidents, and gives you a workspace for chasing down problems in production. The MCP server exposes the same data to an agent: instead of pasting console output into chat, you ask for the logs or traces you need.
The community edition in the repo ships a web app and API, an OTLP intake proxy, workers that group incidents and run background jobs, a Postgres schema, and telemetry queries backed by ClickHouse. Investigation runtimes are pluggable, and a default community runner writes a local incident summary. Running it locally takes Node.js 20+, pnpm 9+ and Docker — bring the stack up with docker compose up -d, run migrations, then pnpm dev. The services listen on http://localhost:5173, http://localhost:4100 and http://localhost:4101.
The hosted endpoint sits at https://api.superlog.sh/mcp, so pointing an agent at it needs no local stack and no API key. Apache-2.0 means you can read and modify the code.
What it helps with
- trace a production failure back to its cause
- turn scattered alerts into one incident
- run an OpenTelemetry stack locally for debugging
- give an agent access to production metrics
- review what broke overnight
Example prompts for the agent
- List the latest Superlog incidents and dig into the most recent one
- Find requests in the traces that took over a second in the last hour
- Pull metrics for the
apiservice and show me where p95 dropped
How to install Superlog
Platform CLI: remote server
claude mcp add --transport http superlog https://api.superlog.sh/mcpPlatform CLI: remote server
codex mcp add superlog --url https://api.superlog.sh/mcpConfig file
{
"mcpServers": {
"superlog": {
"url": "https://api.superlog.sh/mcp"
}
}
}Config file
{
"servers": {
"superlog": {
"type": "http",
"url": "https://api.superlog.sh/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http superlog https://api.superlog.sh/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Superlog
How do I install Superlog in Claude Code?
Run claude mcp add --transport http superlog https://api.superlog.sh/mcp. The server then shows up in your agent's MCP server list.
What does Superlog do?
It ingests traces, logs and metrics, groups signals into incidents, and lets an agent query them over MCP. It is also an open workspace for debugging production systems.
Do I need the local stack to use the MCP server?
No — the server connects to https://api.superlog.sh/mcp. The Docker and Postgres setup is for running the community edition yourself.
