com.botrecipe/budget

up checked 2026-11-10T23:37:43.373Z

Unclaimed · Unverified

Publisher-provided title

Run Budget Guard

Publisher-provided description

Hard dollar, token, call and time caps shared by every sub-agent in one agent run.

Summary by lookupd

Lets an agent set and enforce hard dollar, token, call, and time budgets across sub-agents, then check spend and stop status.

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http budget https://budget.cloudforbots.com/mcp

Codex, remote (streamable-http)

codex mcp add budget --url https://budget.cloudforbots.com/mcp

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "budget": {
      "url": "https://budget.cloudforbots.com/mcp"
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Publisher-provided text

open_budget Open a hard budget for one agent run before it starts: max dollars, tokens, calls and/or wall-clock seconds. Returns a handle. Give the handle to every sub-agen
reserve Call BEFORE each model call, tool call or sub-agent spawn with your estimate. Returns allowed=true and deducts it, or allowed=false with the limit that tripped.
record After a call, report the actual usage minus what you reserved (positive if it cost more, negative to give back an overestimate). Keeps the ledger honest without
weekly_report Draft a plain-English report of the last 7 days for your key (or IP): runs, spend, runs that went over their cap, and dollars spent after a cap would have stopp
budget_status See spend vs limits, remaining budget, whether the run is stopped and why, and the last 20 ledger events. Set close=true when the run finishes.
usage_and_upgrade Show today's usage for your key or IP and the $49/month All Access upgrade link (cloudforbots.com/offer). Free tier: 500 calls/day. Not metered.

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/com.botrecipe/budget.svg)](https://lookupd.com/servers/com.botrecipe/budget)