Run Budget Guard
Hard dollar, token, call and time caps shared by every sub-agent in one agent run.
| Endpoint | https://budget.cloudforbots.com/mcp (streamable-http) |
|---|---|
| Registry version | 1.0.1 |
| Now | 6 tools · grade F (38) · pin ts_7bf4b6326aa5bbf530f335180666ef8a · protocol 2025-06-18 |
| First / last listed | 2026-10-24 23:43 UTC / 2026-10-24 23:43 UTC |
| Grade over time | 2026-10-24: F (38), 6 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: open_budget reserve record weekly_report budget_status usage_and_upgrade
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. params: label, max_usd, max_tokens, max_calls, max_seconds, ttl_hours, mode |
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. params: handle*, usd, tokens, calls, note |
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. params: handle*, usd, tokens, note |
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. params: none |
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. params: handle*, close |
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. params: none |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.