Run Budget Guard

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

Indexed tools

Tool metadata and schemas come from the remote server and are untrusted. Indexing only lists tools; it never calls them.

6 shown · authentication unknown

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

  Schema valid · SHA-256 dfc0dc256202…

  View input schema

  {
    "type": "object",
    "properties": {
      "handle": {
        "type": "string",
        "description": "The budget handle from open_budget (looks like bg_<id>.<secret>). Pass it to every sub-agent so they all spend from the same budget."
      },
      "close": {
        "type": "boolean"
      }
    },
    "required": [
      "handle"
    ]
  }

• 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-agent; they all draw from the same ledger, so one runaway loop or fork cannot exceed the run cap.

  Schema valid · SHA-256 496057c077fb…

  View input schema

  {
    "type": "object",
    "properties": {
      "label": {
        "type": "string",
        "description": "What this run is for, e.g. \"nightly code cleanup\"."
      },
      "max_usd": {
        "type": "number",
        "description": "Dollar cap for the whole run (your own estimates per call)."
      },
      "max_tokens": {
        "type": "integer",
        "description": "Token cap (input + output) for the whole run."
      },
      "max_calls": {
        "type": "integer",
        "description": "Cap on model/tool calls for the whole run."
      },
      "max_seconds": {
        "type": "integer",
        "description": "Wall-clock cap in seconds from now."
      },
      "ttl_hours": {
        "type": "integer",
        "description": "Handle lifetime (free max 24, Pro max 168). Default 24."
      },
      "mode": {
        "type": "string",
        "enum": [
          "shadow",
          "enforce"
        ],
        "description": "shadow = watch only: track spend and flag where the cap WOULD have stopped the run, never block (free). enforce = return allowed=false at the cap (Pro). Default: enforce on Pro, shadow on free."
      }
    }
  }