# Runheed

> Production errors your coding agent can read: search, stack traces, context, trends, resolve.

- name: com.runheed/runheed
- version: 1.0.1
- connection class: R0 (autonomous)
- trust: 96/100
- quality: 85/100 (new)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/com.runheed%2Frunheed
- tools: https://api.protogrid.dev/v1/servers/com.runheed%2Frunheed/tools

**An agent can connect right now, no human step.** Remote endpoint, no authentication, reachable on the last probe.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "runheed": {
      "type": "http",
      "url": "https://runheed.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ${RUNHEED_TOKEN}"
      }
    }
  }
}
```

Placeholders to fill: `${RUNHEED_TOKEN}`.

## Trust

- hygiene: 100
- liveness: 100
- freshness: 100
- provenance: 85
- drivers: +repository +dns-namespace +website +reachable +uptime-100% +updated-2d-ago
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 85/100 (new)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 93 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- pass `tools.annotations`: 9 of 9 tools declare readOnlyHint or destructiveHint
- warn `tools.directory_hints`: 3 of 9 tools declare all four hints; missing: runheed_get_error (idempotentHint); runheed_get_trends (idempotentHint); runheed_get_error_context (idempotentHint); …
- pass `tools.token_cost`: about 1,250 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: n/a (weight 15)

- n/a `stability.changes`, `stability.rug_pull`: tool history recorded for 5 of the 7 days needed

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 9, about 1,250 tokens to load them all
- tool set hash: 5b2b9b1f3271c2b43d6ce96e9727c51a
- tools last changed: 2026-11-07T16:25:54.884Z
- badge: [![protogrid quality](https://protogrid.dev/badge/com.runheed/runheed.svg)](https://protogrid.dev/servers/com.runheed/runheed)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

- 2026-11-07 `runheed_get_error` changed (description)
  - before: Returns one error group in full: message, status, counts, first and last seen, environment, agent context, the top stack frames and the latest breadcrumbs.
  - after: 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.
- 2026-11-06 `runheed_get_recent` changed (description)
  - before: Returns the error groups seen most recently, newest first, with status, type, message, event count, last-seen time and ID.
  - after: Returns the error groups seen most recently, newest first, with status, type, message, route, top stack frame, event count, last-seen time and ID.
- 2026-11-06 `runheed_search_errors` changed (description, inputSchema)
  - before: 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.
  - after: Searches the workspace's error groups by text (type, message, route, file or extra data), status and project. Returns each matching group with its status, type, message, route, top stack frame, event count, last-seen time and ID.
- 2026-11-02 `runheed_get_project_health` changed (inputSchema)
- 2026-11-02 `runheed_get_trends` changed (inputSchema)
- 2026-11-02 `runheed_get_recent` changed (inputSchema)
- 2026-11-02 `runheed_search_errors` changed (inputSchema)

Full history: https://api.protogrid.dev/v1/servers/com.runheed%2Frunheed/changes

## Remotes

- https://runheed.com/api/mcp (streamable-http, auth none, reachable true, uptime30d 1)

## Packages

_none_

## Tools (9)

- `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. 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.
- `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_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.
- `runheed_get_recent`: Returns the error groups seen most recently, newest first, with status, type, message, route, top stack frame, 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_ignore_error`: Marks an error group ignored, for known or expected errors, so new occurrences stop alerting. Returns a confirmation.
- `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_search_errors`: Searches the workspace's error groups by text (type, message, route, file or extra data), status and project. Returns each matching group with its status, type, message, route, top stack frame, event count, last-seen time and ID.
- `runheed_unignore_error`: Moves an ignored error group back to unresolved, so new occurrences alert again. Returns a confirmation.