Runheed — Claude Code MCP server: errors and setup
Runheed — an MCP server for Claude Code gives an agent access to errors from Node.js and Python apps. It can search error groups, inspect stack traces and context, then change an error’s status.
MIT updated 2026-11-09
claude mcp add --transport http runheed https://runheed.com/api/mcpWhat Runheed does
Runheed exposes application error data to an agent over MCP, including messages, stack traces, environments and events around a failure. The agent can search groups by text, status or project, view recent errors and period-based statistics, and retrieve a project health score.
Read tools leave data unchanged. Three status tools can resolve or ignore an error group, and move an ignored group back to unresolved. An app needs the Runheed SDK for Node.js/TypeScript or Python, or an HTTP integration, to send errors to the service. Access requires a Runheed account using OAuth or an agent key. The service is paid, and events above a plan’s limit are rejected.
What it helps with
- find an error group by message, status or project
- inspect a stack trace and the events around a failure
- compare error statistics across a selected period
- mark a fixed or expected error group
Example prompts for the agent
- Find project errors matching
TypeErrorand show the newest stack trace. - Show the context for this error, including its environment, release and preceding events.
- Mark this error group resolved and add a note about the commit.
How to install Runheed
Platform CLI: remote server
claude mcp add --transport http runheed https://runheed.com/api/mcpPlatform CLI: remote server
codex mcp add runheed --url https://runheed.com/api/mcpConfig file
{
"mcpServers": {
"runheed": {
"url": "https://runheed.com/api/mcp"
}
}
}Config file
{
"servers": {
"runheed": {
"type": "http",
"url": "https://runheed.com/api/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http runheed https://runheed.com/api/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 Runheed
How do I install Runheed in Claude Code?
Run claude mcp add --transport http runheed https://runheed.com/api/mcp, then open /mcp and choose Authenticate.
What does Runheed do?
It lets an agent search application error groups and inspect their traces, context and statistics. The agent can also change an error’s status.
What does Runheed need to work?
It requires a Runheed account accessed through OAuth or an agent key, plus the Node.js/TypeScript or Python SDK, or an HTTP integration to send errors. The service is paid.