Runheed MCP server
Commit Nov 9, 2026Lets coding agents monitor production errors, read stack traces, analyze trends, and resolve bugs directly through an MCP client.
Also known as getrunheed/runheed-plugin, runheed-plugin
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- 1.0.1
- Last commit
- Nov 9, 2026
- License
- MIT
What is Runheed MCP?
Runheed lets coding agents monitor production errors, read stack traces, analyze trends, and resolve bugs directly through an MCP client.
Summary generated from the project's README
About Runheed MCP server
Runheed provides an error tracking interface designed specifically for coding agents to monitor production environments. It captures exceptions from Node.js or Python applications and exposes them through an MCP server. This allows AI clients like Claude Code, Cursor, Codex, and ChatGPT to access stack traces and error data directly. The service is hosted and connects via a streamable HTTP transport.
Developers can set up the server using OAuth or an agent key. The system includes specific tools for different tasks, such as runheed_search_errors for finding specific issues, runheed_get_error_context for viewing breadcrumbs and runtime details, and runheed_get_trends for analyzing statistics over 24 hours, 7 days, or 30 days. While most tools are read-only, agents can also use runheed_resolve_error to mark bugs as fixed or runheed_ignore_error to handle expected exceptions.
Subscription plans offer different event limits and history durations. The Solo plan includes 50,000 events and 30-day history, while the Scale plan provides 1,000,000 events and 180-day history. This setup enables an autonomous workflow where an agent identifies a bug, analyzes the context, and applies a fix.
What you can do with it
- 1Analyze production error trendsAsk your agent to retrieve error statistics for the last 30 days to identify recurring issues.
- 2Debug specific stack tracesHave an AI client retrieve the full message, counts, and top stack frames for a specific error group.
- 3Automate bug resolutionInstruct an agent to mark a specific error as resolved after it has implemented a fix.
- 4Monitor project health scoresRequest a health score for a project to see recent issues and receive recommendations.
Written from the project's README. Every use case is checked against a quote from it.
How to install Runheed MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Runheed MCP in Claude Code
$ claude mcp add --transport http runheed-plugin https://runheed.com/api/mcpInstall Runheed MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"runheed-plugin": {
"url": "https://runheed.com/api/mcp"
}
}
}Install Runheed MCP in VS Code
.vscode/mcp.json
{
"servers": {
"runheed-plugin": {
"type": "http",
"url": "https://runheed.com/api/mcp"
}
}
}Install Runheed MCP in VS Code CLI
$ code --add-mcp '{"name":"runheed-plugin","type":"http","url":"https://runheed.com/api/mcp"}'Install Runheed MCP in Codex
$ codex mcp add runheed-plugin --url https://runheed.com/api/mcpInstall Runheed MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.runheed-plugin] url = "https://runheed.com/api/mcp"
Install Runheed MCP in Gemini CLI
$ gemini mcp add -s user --transport http runheed-plugin https://runheed.com/api/mcpInstall Runheed MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"runheed-plugin": {
"url": "https://runheed.com/api/mcp",
"type": "http"
}
}
}Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablegetrunheed/runheed-plugin is public and reachablegithub.com/getrunheed/runheed-plugin ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-09github.com/getrunheed/runheed-plugin ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 33 msPass
README
View on GitHubRunheed
Error tracking your coding agent can read. Runheed catches exceptions in your Node.js or Python app and serves them over MCP, so Claude Code, Cursor, Codex or any MCP client can read the stack trace, fix the bug and mark it resolved.
- Website: https://runheed.com
- MCP server:
https://runheed.com/api/mcp(Streamable HTTP). Sign in with OAuth (claude.ai, ChatGPT, Claude Code, Cursor, Codex), or sendAuthorization: Bearer al_...with an agent key. - Setup for agents: https://runheed.com/SETUP.txt
This repo holds the Claude Code plugin, the Google Antigravity plugin, the agent skill and the MCP config. The Runheed service itself is hosted.
Try it first
A demo server holds invented sample errors. It takes no account or key, and nothing is saved:
claude mcp add --transport http runheed-demo https://runheed.com/api/mcp/demo
Then ask your agent: "What is the top Runheed error, and what would you change?" Setup for other clients: https://runheed.com/demo#try
Install
Claude Code plugin (signs you in on first use, no key to copy):
/plugin marketplace add getrunheed/runheed-plugin
/plugin install runheed@runheed
Or add the server directly:
| Client | How |
|---|---|
| Claude Code | claude mcp add --transport http --scope user runheed https://runheed.com/api/mcp, then run /mcp and choose Authenticate |
| Codex | codex mcp add runheed --url https://runheed.com/api/mcp then codex mcp login runheed |
| claude.ai / Claude Desktop | Customize > Connectors > Add custom connector, URL https://runheed.com/api/mcp |
| ChatGPT | Plugins > + > Add custom MCP server, URL https://runheed.com/api/mcp, OAuth |
| Cursor | Add {"mcpServers": {"runheed": {"url": "https://runheed.com/api/mcp"}}} to ~/.cursor/mcp.json, then sign in from Cursor Settings > MCP |
| Google Antigravity | agy plugin install https://github.com/getrunheed/runheed-plugin (this repo is also an Antigravity plugin: .antigravity-plugin/plugin.json + mcp_config.json), or add {"mcpServers": {"runheed": {"serverUrl": "https://runheed.com/api/mcp"}}} to ~/.gemini/config/mcp_config.json and click Authenticate under Customizations |
| Gemini CLI | gemini extensions install https://github.com/getrunheed/runheed-plugin |
Then add the SDK to your app (Node.js / TypeScript, Python, or plain HTTP). Your agent can do both steps from https://runheed.com/SETUP.txt.
Install the skill in any agent
skills/runheed/SKILL.md tells an agent when to reach for Runheed and how to set it up. It's the same file served at https://runheed.com/SKILL.md.
What your agent can do
| Tool | What it does |
|---|---|
runheed_search_errors |
Searches the workspace's error groups by text (type or message), status and project. |
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. |
runheed_get_recent |
Returns the error groups seen most recently, newest first. |
runheed_get_trends |
Returns error statistics for the last 24 hours, 7 days or 30 days. |
runheed_get_error_context |
Returns everything recorded around an error: breadcrumbs, runtime, environment, release, the affected user and the agent session. |
runheed_resolve_error |
Marks an error group resolved, with an optional note such as the fixing commit. |
runheed_ignore_error |
Marks an error group ignored, for known or expected errors. |
runheed_unignore_error |
Moves an ignored error group back to unresolved. |
runheed_get_project_health |
Returns a 0 to 100 health score for a project, with recent issues and recommendations. |
Read tools are read-only; the three status tools only flip an error's status, which can be flipped back.
Pricing
One flat price per workspace, every plan includes the MCP server:
- Solo: $29 a month. 50,000 events a month, 3 projects, 30-day history.
- Pro: $79 a month. 250,000 events a month, 15 projects, 90-day history.
- Scale: $199 a month. 1,000,000 events a month, unlimited projects, 180-day history.
Events over your plan's limit are rejected, never charged. Details: https://runheed.com/pricing
Support and contributing
Questions: hello@greatwork.company. Issues and pull requests for the skill and plugin files are welcome here.
Privacy
Privacy policy: https://runheed.com/privacy. Terms: https://runheed.com/terms
License
MIT. Runheed is made by Great Work LLC.
Runheed MCP questions
How do I add Runheed MCP to Claude Code?
Run claude mcp add --transport http runheed-plugin https://runheed.com/api/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Runheed MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
How can I test Runheed without setting up an account?
You can use a demo server that provides invented sample errors without requiring a key or saving any data.
Can my agent actually fix bugs using Runheed?
Yes, the server provides the necessary context, such as stack traces and breadcrumbs, so agents like Claude Code or Cursor can identify and fix bugs.