Runheed MCP Server

About Runheed

Runheed is an error tracker built for coding agents. A Node.js or Python SDK reports production errors with the stack trace, breadcrumbs and request; Claude Code, Cursor, Codex, Windsurf or any MCP client reads them over MCP.

Tools (9): runheed_get_recent, runheed_search_errors, runheed_get_error, runheed_get_error_context, runheed_get_trends, runheed_get_project_health, runheed_resolve_error (takes the fixing commit), runheed_ignore_error, runheed_unignore_error.

Auth: OAuth 2.1 with dynamic client registration (connect by URL), or a Bearer agent key. A stdio server (runheed-mcp) is also available.

Pricing: paid plans, Solo $29/month (50,000 events), Pro $79, Scale $199, each with a 7-day trial. Try the tools on sample errors without an account at https://runheed.com/demo.

Docs: https://runheed.com/mcp-server

Runheed tools (12)

Read from the live server on Nov 13, 2026. These are the tools your AI assistant can call once connected.

runheed_search_errors

Searches the workspace's error groups by text (type, message, route, file or extra data), status, project and release (including only the errors a release introduced). Returns each matching group with its status, type, message, route, top s

runheed_get_error

Returns one error group in full: message, status, counts, first and last seen, environment, agent context, the top stack frames and the latest breadcrumbs. If the error came back after it was marked resolved, it also shows the note it was r

runheed_get_recent

Returns the error groups seen most recently, newest first, with status, type, message, route, top stack frame, event count, last-seen time and ID.

runheed_get_trends

Returns error statistics for the last 24 hours, 7 days or 30 days: total, new and resolved counts, the most frequent errors and the hourly error rate.

runheed_get_error_context

Returns everything recorded around an error: every breadcrumb, platform, runtime, OS, environment, release, the affected user, the agent session and extra data.

runheed_resolve_error

Marks an error group resolved, with an optional note such as the fixing commit. The group reopens on its own if the error happens again. Returns a confirmation.

runheed_ignore_error

Marks an error group ignored, for known or expected errors, so new occurrences stop alerting. Returns a confirmation.

runheed_unignore_error

Moves an ignored error group back to unresolved, so new occurrences alert again. Returns a confirmation.

runheed_get_project_health

Returns a 0 to 100 health score for a project (or the whole workspace), errors in the last 24 hours, the unresolved count, the error rate, recent issues and recommendations.

runheed_list_projects

Lists the workspace's projects with each project's ID, slug, platform and DSN (the value an app sets as RUNHEED_DSN to report errors).

runheed_create_project

Creates a project in the workspace and returns its DSN: the value an app sets as the RUNHEED_DSN environment variable so that runheed.init() reports its errors to this project.

runheed_send_test_event

Sends one test error (RunheedTestEvent) to a project through the normal ingest path, which shows whether the project and its send key work. The test error appears in the recent errors and can be resolved like any other.

How to connect Runheed to Claude, Cursor or VS Code

Runheed runs as a hosted remote MCP server at https://runheed.com/api/mcp. Add that URL to your MCP client's config (Claude Code, Cursor, Windsurf or VS Code) and the tools appear immediately, no install required.

{
  "mcpServers": {
    "runheed": {
      "url": "https://runheed.com/api/mcp"
    }
  }
}

Claude Code: claude mcp add --transport http runheed https://runheed.com/api/mcp. VS Code's .vscode/mcp.json uses a servers key instead of mcpServers (see how). Servers that require OAuth or an API key will prompt on first use.