# runvouch

Monitors unattended agent executions, checks for required deliverables, and halts runs that exceed spending caps.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: runvouch
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/runvouch/runvouch
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/runvouch

## What it does

This MCP server exposes methods like `runvouch_status`, `alerts`, `run_start`, and `run_end` directly to the assistant. It tracks background sessions, ensuring automated runs do not fail silently or claim completion when output files are missing. Each finished execution generates a sha256 digest linked into daily Merkle structures stamped via Bitcoin.

Built-in detectors catch runaway loops. The server alerts on repetitive tool retries, dead cron schedules, and runtime drift. When a job hits your cost ceiling on paid tiers, the platform freezes subsequent executions until you resume them manually.

You need a valid `RUNVOUCH_KEY` or a self-hosted FastAPI instance running SQLite. Without an active endpoint or credentials, the server cannot log runs.

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

## Install

### Claude Code (native platform)

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

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

## When to use it
- stop repetitive tool loops from draining API balances
- verify that required output artifacts exist before marking a task done
- audit unattended runs with cryptographic proof
- route agent failure alerts to webhooks or chat channels

## Example prompts
- Check RunVouch for any unacknowledged alerts from recent runs
- Mark the start of our scheduled sync using `runvouch_run_start`
- Retrieve the latest execution status for this workspace via RunVouch

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

---
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