runvouch — Claude Code MCP server: what it does, how to install
Monitors unattended agent executions, checks for required deliverables, and halts runs that exceed spending caps.
claude mcp add --transport http runvouch https://api.runvouch.com/mcpWhat runvouch 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.
What it helps with
- 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 for the agent
- 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
How to install runvouch
Platform CLI: remote server
claude mcp add --transport http runvouch https://api.runvouch.com/mcpPlatform CLI: remote server
codex mcp add runvouch --url https://api.runvouch.com/mcpConfig file
{
"mcpServers": {
"runvouch": {
"url": "https://api.runvouch.com/mcp"
}
}
}Config file
{
"servers": {
"runvouch": {
"type": "http",
"url": "https://api.runvouch.com/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http runvouch https://api.runvouch.com/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about runvouch
How to install runvouch in Claude Code?
Run claude mcp add --transport http runvouch https://api.runvouch.com/mcp in your terminal.
What does runvouch do?
It provides telemetry and watchdog checks for background agents, confirming tasks produced tangible outputs and warning you about cost spikes.
Can I self-host runvouch instead of using the cloud?
Yes, the repository contains a standalone FastAPI and SQLite server that runs via Docker Compose or a standard Python environment.
