# Runheed [Health: Active]

**Category:** 📊 Monitoring  
**Repository:** https://runheed.com/mcp-server?ref=allmcps  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/runheed

## Description
Error tracking your coding agent can read. Runheed catches exceptions from your Node.js or Python app and serves them over a hosted MCP endpoint with OAuth, so Claude Code, Cursor, Codex or any MCP client can search production errors, read stack traces and request context, see trends, fix the bug and mark it resolved. Paid plans from $29/month.

## Tools
Capabilities this server exposes over MCP:

- **runheed_search_errors** — Searches the workspace's error groups by text (type or message), status and project. Returns each matching group with its status, type, message, event count, last-seen time and ID.
- **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, with status, type, message, 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.

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What Runheed does

Runheed brings production error data into MCP-compatible coding agents. It collects exceptions from Node.js and Python applications and organizes them into error groups that agents can query by text, status, and project. Each group includes identifying information such as its type, message, occurrence count, timestamps, and status.

The service is intended for debugging workflows where an agent needs more than a log line. It can expose stack frames, breadcrumbs, runtime and platform details, release and environment information, affected users, agent sessions, and additional recorded data. Agents can also inspect workspace or project health, including recent error activity, unresolved issues, error rate, trends, and recommendations.

## How it works

Runheed exposes its functionality through a hosted MCP endpoint protected with OAuth. An MCP client connects to that endpoint, allowing an agent to call error-tracking tools during a coding session. The agent can search for an issue, retrieve its full details or surrounding context, examine recent activity and longer-term statistics, and update the issue's state.

Resolved errors can reopen automatically when they occur again. Ignored errors remain excluded from new alerting until they are moved back to an unresolved state. A resolution can include an optional note, such as a fixing commit, to preserve a link between the issue and the change that addressed it.

## Tools and capabilities

- Search error groups by message or type, status, and project.
- Retrieve a complete error group with counts, timestamps, environment, agent context, stack frames, and recent breadcrumbs.
- List the most recently seen error groups.
- Review statistics for the previous 24 hours, 7 days, or 30 days.
- Retrieve all recorded context surrounding an error.
- Mark errors resolved, optionally adding a note.
- Mark known or expected errors ignored, or restore them to unresolved.
- Check a project or workspace health score from 0 to 100.

The trend data includes total, new, and resolved counts, frequent errors, and hourly error rate. Project health also includes recent issues and recommendations.

## Setup and configuration

Runheed is accessed as a hosted MCP service rather than as a local process. Configure an MCP-compatible client to connect to its OAuth-protected endpoint, then authorize access. The service is designed for Claude Code, Cursor, Codex, and other MCP clients.

The monitored application scope is Node.js or Python. Once application exceptions are available to Runheed, the MCP tools expose them to the connected agent for investigation and status updates. Paid plans start at $29 per month.

## Limitations and notes

Runheed focuses on captured application exceptions and their associated diagnostic context. Its documented application coverage is Node.js and Python. Actions that change issue state include resolving, ignoring, and unignoring error groups; these changes affect how subsequent occurrences are handled. Resolved groups reopen if the same error happens again, while ignored groups stop generating alerts until restored.

_Full upstream README: https://allmcps.com/mcp/runheed/readme_