Directory / Agents, IDEs & developer tools
Runheed
Error tracking your coding agent can read: search production errors, read stack traces and breadcrumbs, and resolve them with the fixing commit. Paid, OAuth sign-in or API key. Endpoint: https://runheed.com/api/mcp · Website
Live Answered an MCP handshake without credentials and listed 13 tools.
- Category
- Agents, IDEs & developer tools
- Transport
http- Source
- https://github.com/getrunheed/runheed-plugin
- Endpoint
https://runheed.com/api/mcp- MCP Registry
com.runheed/runheed- Reports itself as
- runheed 0.1.0
- Protocol
- 2025-06-18
- Tools
- 13
- Context cost
- about 1,978 tokens for the tool definitions (estimated at four characters per token)
- Tool definitions last changed
- no change seen since first check
- Handshake time
- 191 ms
- Repository
- 0 stars · last push 2026-11-20 · MIT
- Last checked
- 2026-11-22 11:27:47 UTC
- Listed since
- 2026-11-18
Health and compatibility
| Endpoint reachable | Verified | Responded in 191 ms |
|---|---|---|
| MCP handshake (initialize) | Verified | Completed without credentials |
| Tool discovery (tools/list) | Verified | 13 tools listed |
| Authentication | Verified | None needed to connect |
| Protocol version | Verified | 2025-06-18 |
| Transport | Verified | Streamable HTTP |
| Capabilities declared | Verified | tools |
Last checked . Verified means the check saw it happen; it says nothing about whether the server is safe.
Recent history
5 daily checks so far; median response 191 ms. Green answered, violet asked for auth, red did not answer.
Set up in your client
Claude Code
Run this in a terminal:
claude mcp add --transport http runheed https://runheed.com/api/mcpClaude Desktop
Open Settings → Connectors → Add custom connector and paste this URL:
https://runheed.com/api/mcpOr bridge it through mcp-remote in claude_desktop_config.json (needs Node.js):
{
"mcpServers": {
"runheed": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://runheed.com/api/mcp"
]
}
}
}Cursor
Or add it to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": {
"runheed": {
"url": "https://runheed.com/api/mcp"
}
}
}VS Code
Or add it to .vscode/mcp.json:
{
"servers": {
"runheed": {
"type": "http",
"url": "https://runheed.com/api/mcp"
}
}
}Or from a terminal:
code --add-mcp '{"name": "runheed", "type": "http", "url": "https://runheed.com/api/mcp"}'Windsurf
Add it to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"runheed": {
"serverUrl": "https://runheed.com/api/mcp"
}
}
}Other clients
Most clients accept this shape. The endpoint is:
https://runheed.com/api/mcp{
"mcpServers": {
"runheed": {
"type": "http",
"url": "https://runheed.com/api/mcp"
}
}
}If it does not connect
- Restart the client after editing a config file, and keep keys out of files you commit.
- If the tools do not appear, open the client's MCP log: a 401 means the credentials were not accepted, and a timeout means the server did not answer.
Tools 13
Names, descriptions and input schemas exactly as the server returned them on 2026-11-22. This is the server author's own text. Nothing is run from this page. Labels such as read-only are declared by the server and are not verified. Raw JSON
runheed_create_projectcan modifyCreates a project in the workspace and returns its DSN: the value an app sets as the RUNHEED_DSN environment …
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.
| Parameter | Type | Description | |
|---|---|---|---|
name | string | required | Project name, usually the app or service name, for example shop-api |
platform | string | optional | The app's platform One of: node, python, react, react-native, ios, android, other |
slug | string | optional | Optional URL-safe slug; derived from the name when left out |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "runheed_create_project",
"arguments": {
"name": "..."
}
}
}runheed_get_errorread-onlyReturns one error group in full: message, status, counts, first and last seen, environment, agent context, …
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 resolved with, so you can see what the last fix tried. For a resolved error it reports whether the fix held: events since, releases deployed since and whether the fixing commit is live.
| Parameter | Type | Description | |
|---|---|---|---|
errorId | string | required | The error ID to get details for |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "runheed_get_error",
"arguments": {
"errorId": "..."
}
}
}runheed_get_error_contextread-onlyReturns everything recorded around an error: every breadcrumb, platform, runtime, OS, environment, release, …
Returns everything recorded around an error: every breadcrumb, platform, runtime, OS, environment, release, the affected user, the agent session and extra data.
| Parameter | Type | Description | |
|---|---|---|---|
errorId | string | required | The error ID to get context for |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "runheed_get_error_context",
"arguments": {
"errorId": "..."
}
}
}runheed_get_project_healthread-onlyReturns a 0 to 100 health score for a project (or the whole workspace), errors in the last 24 hours, the …
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.
| Parameter | Type | Description | |
|---|---|---|---|
projectId | string | optional | Project id or slug (e.g. shop-api); all projects if not specified |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "runheed_get_project_health",
"arguments": {}
}
}runheed_get_recentread-onlyReturns the error groups seen most recently, newest first, with status, type, message, route, top stack …
Returns the error groups seen most recently, newest first, with status, type, message, route, top stack frame, event count, last-seen time and ID.
| Parameter | Type | Description | |
|---|---|---|---|
limit | number | optional | Number of recent errors to return |
projectId | string | optional | Filter by project id or slug (e.g. shop-api) |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "runheed_get_recent",
"arguments": {}
}
}runheed_get_trendsread-onlyReturns error statistics for the last 24 hours, 7 days or 30 days: total, new and resolved counts, the most …
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.
| Parameter | Type | Description | |
|---|---|---|---|
period | string | optional | Time period to analyze One of: 24h, 7d, 30d |
projectId | string | optional | Filter by project id or slug (e.g. shop-api) |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "runheed_get_trends",
"arguments": {}
}
}runheed_ignore_errorcan modifyMarks one error group ignored (errorId), or up to 100 at once (errorIds), for known or expected errors such …
Marks one error group ignored (errorId), or up to 100 at once (errorIds), for known or expected errors such as browser noise, so new occurrences stop alerting. Returns what changed.
| Parameter | Type | Description | |
|---|---|---|---|
errorId | string | optional | The error ID to ignore |
errorIds | string[] | optional | Several error IDs to ignore with the same reason (up to 100) |
reason | string | optional | Reason for ignoring this error |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "runheed_ignore_error",
"arguments": {}
}
}runheed_list_projectsread-onlyLists the workspace's projects with each project's ID, slug, platform and DSN (the value an app sets as …
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).
Takes no parameters.
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "runheed_list_projects",
"arguments": {}
}
}runheed_merge_errorscan modifyMerges error groups that are the same bug into one: their events move to the target group (targetId) and new …
Merges error groups that are the same bug into one: their events move to the target group (targetId) and new events with their fingerprints join it too. With groupByMessagePrefix, new events of the target's type whose message starts with that text also join it, for messages that differ only by an ID or a number. Returns what was merged.
| Parameter | Type | Description | |
|---|---|---|---|
targetId | string | required | The error group to keep |
errorIds | string[] | required | Error groups to merge into the target (same project) |
groupByMessagePrefix | string | optional | Optional message prefix: new events of the target's type whose message starts with it are grouped into the target |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "runheed_merge_errors",
"arguments": {
"targetId": "...",
"errorIds": []
}
}
}runheed_resolve_errorcan modifyMarks one error group resolved (errorId), or up to 100 at once (errorIds) for duplicates fixed by the same …
Marks one error group resolved (errorId), or up to 100 at once (errorIds) for duplicates fixed by the same change, with an optional note such as the fixing commit. A group reopens on its own if the error happens again. Returns what changed.
| Parameter | Type | Description | |
|---|---|---|---|
errorId | string | optional | The error ID to resolve |
errorIds | string[] | optional | Several error IDs to resolve with the same note (up to 100) |
comment | string | optional | Optional comment about the fix |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "runheed_resolve_error",
"arguments": {}
}
}runheed_search_errorsread-onlySearches the workspace's error groups by text (type, message, route, file or extra data), status, project and …
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 stack frame, event count, last-seen time and ID.
| Parameter | Type | Description | |
|---|---|---|---|
query | string | optional | Text to find in the error type, message, route, stack frames or extra data, for example a route or a file name |
status | string | optional | Filter by error status One of: unresolved, resolved, ignored |
projectId | string | optional | Filter by project id or slug (e.g. shop-api) |
release | string | optional | Only errors with an event from this release (the release value the app passes to init, often a commit SHA) |
newInRelease | boolean | optional | With release: only errors that first appeared in that release, to check what a deploy introduced |
limit | number | optional | Maximum number of errors to return |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "runheed_search_errors",
"arguments": {}
}
}runheed_send_test_eventcan modifySends one test error (RunheedTestEvent) to a project through the normal ingest path, which shows whether the …
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.
| Parameter | Type | Description | |
|---|---|---|---|
projectId | string | required | Project id or slug |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "runheed_send_test_event",
"arguments": {
"projectId": "..."
}
}
}runheed_unignore_errorcan modifyMoves one ignored error group (errorId), or up to 100 (errorIds), back to unresolved, so new occurrences …
Moves one ignored error group (errorId), or up to 100 (errorIds), back to unresolved, so new occurrences alert again. Returns what changed.
| Parameter | Type | Description | |
|---|---|---|---|
errorId | string | optional | The error ID to unignore |
errorIds | string[] | optional | Several error IDs to unignore (up to 100) |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "runheed_unignore_error",
"arguments": {}
}
}Badge
Maintain this server? Put its live status in your README:
[](https://mcp.aianytime.net/s/runheed/)Edit this entry · Report a problem
More in Agents, IDEs & developer tools
Checks record what a server answered, not whether it is safe. A listing is not a security audit; read a server's source and permissions before you connect it. Add a server · JSON · llms.txt · llms-full.txt
Browse: Agents, IDEs & developer tools · Search & discovery · Knowledge, memory & context · Media & generation · Security · Finance & markets · Marketing, content & social · Cloud, ops & data · Commerce, travel & logistics · Work & productivity · No account needed · Local servers