# Runheed

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: getrunheed
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/getrunheed/runheed-plugin
- Updated: 2026-11-09
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/runheed

## What it 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.

## Requirements
- Remote server: `https://runheed.com/api/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http runheed https://runheed.com/api/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add runheed --url https://runheed.com/api/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "runheed": {
            "url": "https://runheed.com/api/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "runheed": {
            "type": "http",
            "url": "https://runheed.com/api/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http runheed https://runheed.com/api/mcp
```

## When to use it
- 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
- Find project errors matching `TypeError` and 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.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
