# Budgethelm

> Budgethelm is a freemium MCP server for developer tools. Stops AI coding agents stuck in error loops and tracks token spend across tools. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $1.99 a month
- **Platforms:** CLI, macOS, Windows, Linux, API
- **Website:** https://agentops.agentops.workers.dev/en
- **Repository:** https://github.com/xxblv81/budgethelm
- **MCP Registry name:** io.github.xxblv81/budgethelm
- **Categories:** developer tools, AI models and LLM tooling
- **Listing updated:** 2026-11-14

## About

Budgethelm installs guard hooks into the coding agents it finds, such as Claude Code, Codex, Gemini CLI, Copilot CLI and Cursor, and halts a run that keeps failing. The thresholds are published: eight failures in a row, the same error five times, the same command ten times, 25 failures or 500 tool calls since your last message. For Claude Code it also stops a session using over six times your usual tokens in five minutes. Counters reset when you reply, and the stop message includes a command to pause the guard.

Its own tests used a fake model that returned the same error every step. Claude Code stopped at call 6 instead of running to its 60-turn cap, and the other CLIs stopped within a few seconds. The site notes these were local runs, not real spend.

The MCP server is remote and uses OAuth 2.1. Beyond stopping loops, the dashboard reports spend by project, agent and model, flags waste such as missing prompt caching, and scans AGENTS.md, CLAUDE.md and MCP configs for hidden instructions and hard-coded keys. Only timestamps, tool, model, token counts and stop records are uploaded; the site says conversations, code and API keys stay on your machine.

## Features

- **Loop guard hooks:** Stops an agent after repeated failures, repeated commands or runaway tool calls.
- **Token spike detection:** Flags Claude Code sessions far above your usual usage over five minutes.
- **Cross-tool usage:** Shows spend across tools and computers in one place.
- **Waste and savings hints:** Points out missing prompt caching, long outputs and costly models on simple tasks.
- **Config security scan:** Looks for hidden instructions and hard-coded keys in agent config files.
- **Limited upload:** Sends only timestamps, tool, model, token counts and stop records.

## Good for

- Keep unattended claude -p or cron runs from burning tokens
- See which project and model use the most tokens
- Spot hard-coded keys in agent config files
- Compare usage across several computers

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http budgethelm https://agentops.agentops.workers.dev/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://agentops.agentops.workers.dev/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "budgethelm": {
      "url": "https://agentops.agentops.workers.dev/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "budgethelm": {
      "type": "http",
      "url": "https://agentops.agentops.workers.dev/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "budgethelm": {
      "serverUrl": "https://agentops.agentops.workers.dev/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "budgethelm": {
      "type": "http",
      "url": "https://agentops.agentops.workers.dev/api/mcp"
    }
  }
}
```

## FAQ

### What does it upload?

Timestamps, tool, model, token counts and stop records; the site says conversations, code and API keys stay local.

### How do I remove it?

Run node ~/.agentops/agentops-connect.mjs --uninstall, or use the uninstaller for your operating system.

### Is it free?

Free during the beta with every feature; a Pro plan at US$1.99 per month is planned and payments are not open yet.

### Was it renamed?

Yes. It was called AgentOps before 2026-11-10 and keeps some internal names.

### Is Budgethelm free?

Budgethelm has a free plan, with paid plans for more usage or features. Paid plans start at $1.99 a month.

### How do I add Budgethelm to Claude Code?

Run this command in your terminal: claude mcp add --transport http budgethelm https://agentops.agentops.workers.dev/api/mcp

### What are the best alternatives to Budgethelm?

The closest alternatives to Budgethelm are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/budgethelm
