Better Stack — Claude Code MCP server: incidents and telemetry
Remote MCP server for Better Stack: SQL over logs and traces, incident handling, on-call schedules and status pages, driven from your coding agent.
no license 103 installs updated 2026-02-25
claude mcp add --transport http betterstack https://betterstack.run.toolsWhat Better Stack does
The server is remote. Your client talks to https://betterstack.run.tools over HTTP, so nothing runs on the machine. Tools cover telemetry (ClickHouse SQL over logs, spans, errors, metrics), charts and dashboards, incidents, monitors, heartbeats, on-call calendars and status pages.
Query building has a catch. Pull the instruction tool for the data type first, before asking for logs or spans. Skip that step and the SQL comes out wrong. The natural-language builders return queries in Better Stack's own dialect, so they won't run as plain ClickHouse.
Incident work is where it earns its place: read the timeline, leave a comment, escalate to a policy, resolve. Setup differs per client — a single claude mcp add line for Claude, a JSON block with a url field for Cursor and GitHub Copilot.
What it helps with
- walk an incident timeline without leaving the editor
- chart error rates from logs with a SQL query
- check availability and response times for one monitor
- find who is on call this week
- append an update to a status page report
Example prompts for the agent
- List open incidents and pull the timeline for the newest one
- Chart errors from logs over the past week and add the chart to a dashboard
- Who is on call right now?
How to install Better Stack
Platform CLI: remote server
claude mcp add --transport http betterstack https://betterstack.run.toolsPlatform CLI: remote server
codex mcp add better-stack --url https://betterstack.run.toolsConfig file
{
"mcpServers": {
"better-stack": {
"url": "https://betterstack.run.tools"
}
}
}Config file
{
"servers": {
"better-stack": {
"type": "http",
"url": "https://betterstack.run.tools"
}
}
}Platform CLI: remote server
gemini mcp add -t http better-stack https://betterstack.run.toolsStep 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 Better Stack
How do I install Better Stack in Claude Code?
Run claude mcp add --transport http betterstack https://betterstack.run.tools. The transport is set to http.
What does the Better Stack MCP server do?
It gives the agent access to Better Stack monitoring: ClickHouse SQL queries over logs, spans and metrics, plus incidents, monitors, heartbeats, on-call schedules and status pages.
Why does a log query come back broken?
Most likely the instruction tool for that data type was never called, and without it the SQL is assembled incorrectly. Natural-language builders also produce Better Stack syntax, which plain ClickHouse rejects.