Run Budget Guard

com.botrecipePublished by botrecipe.comv1.0.1Updated Oct 25, 2026

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

The publisher's own server: Bot Recipes

VerifiedStreamable HTTPWeb executableFinanceAI & ML

Overview

AI-generated overview

A remote budget-guard server that lets an assistant open a hard dollar, token, call and time cap for one agent run and reserve spend before each call.

What you can do
Open a hard budget for one agent run with dollar, token, call and time limits, returning a shared handle for sub-agents. Reserve estimated cost before each model call, tool call or sub-agent spawn, with an allowed or denied answer naming the limit that tripped. Record actual usage after a call to correct the ledger. Check spend against limits, remaining budget, stop status and recent ledger events, and close the run when finished. Draft a read-only weekly report of runs, spend and cap overruns. Show daily usage and upgrade information.
When to use it
Useful when running multi-step or multi-agent workflows where a runaway loop or fork could overspend, and you want a shared hard cap enforced across sub-agents before each call rather than discovered afterwards.
Requirements
A remote streamable HTTP endpoint; no package, environment variables or headers are declared. The free tier allows 500 calls per day, and usage is tracked by key or IP.
Before you install
The server tracks spend and usage by key or IP, and the upgrade tool points to a paid $49/month plan. Reserving deducts budget and a denied reservation means the assistant should stop and return partial results. The weekly report is read-only and sends nothing.

Installation

In SourceWeft

  1. Open Run Budget Guard in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.botrecipe%2Fbudget/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "run-budget-guard": {
      "type": "http",
      "url": "https://budget.cloudforbots.com/mcp"
    }
  }
}

Tools

6

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.

Parametersmodelabelmax_usdmax_callsttl_hoursmax_tokensmax_seconds

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. When allowed is false, stop, do not retry, and return your partial result to the user. Atomic, so parallel sub-agents cannot both slip under the cap.

Parametersusdnotecallshandlerequiredtokens

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

Parametersusdnotehandlerequiredtokens

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 stopped them. Read-only; sends nothing. Show it to your user.

Takes no parameters.

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.

Parametersclosehandlerequired

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.

Takes no parameters.

Version history

1
  1. v1.0.1LatestOct 15, 2026

Score

72% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts

    Publish an icon in the registry entry.

  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.

Other Botrecipe integrations