{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_pguptc5tb9e2","handle":"tbcontracts-mcp","url":"https://wellknown.network/agents/tbcontracts-mcp","links":{"self":"https://wellknown.network/agents/tbcontracts-mcp/record.json","html":"https://wellknown.network/agents/tbcontracts-mcp","markdown":"https://wellknown.network/agents/tbcontracts-mcp/record.md","api":"https://wellknown.network/api/v1/agents/tbcontracts-mcp","status":"https://wellknown.network/api/v1/agents/tbcontracts-mcp/status","claim":"https://wellknown.network/agents/tbcontracts-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/tbcontracts-mcp/claim.json","badge":"https://wellknown.network/agents/tbcontracts-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/tbcontracts-mcp/history","tools":"https://wellknown.network/api/v1/agents/tbcontracts-mcp/tools"},"ard":{"identifier":"urn:air::server:tbcontracts-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"tbcontracts-mcp","summary":"MCP server exposing token-budget-contracts' priority-weighted budget reallocation as tools for any MCP-aware client.","description":"# tbcontracts-mcp\n\nAn MCP (Model Context Protocol) server that exposes\n[`token-budget-contracts`](https://pypi.org/project/token-budget-contracts/)\nas tools, so any MCP-aware client (Claude Code, Claude Desktop, Cursor,\netc.) can manage token budgets across a multi-agent LLM system.\n\n## What this actually does\n\nMulti-agent orchestrators (a planner spawning a researcher, a writer, a\ncritic, ...) burn tokens unevenly. A high-priority agent can starve\nmid-task while a low-priority agent sits on unused budget. This server's\none job is answering, in real time: **given these agents' priorities and\ncurrent spend, how should the remaining budget move right now?**\n\nIt does this by wrapping `token-budget-contracts`'\npriority-weighted `Reallocator`: spare budget flows from idle or\nlower-priority agents to whichever agent is actually starved, never\nbelow a donor's protected minimum reserve, and never \"uphill\" from a\nmore important agent to a less important one.\n\nThis is **not** a cost-tracking dashboard or a network gateway. See\n[Honest scope](#honest-scope) below.\n\n## Install\n\n```bash\npip install tbcontracts-mcp\n```\n\nThis pulls in `token-budget-contracts>=0.3.0` and `opentelemetry-api` as\ndependencies. Requires Python 3.10+ (see [Why not Python 3.9](#why-not-python-39)).\n\n## Tools\n\n| Tool | What it does |\n|---|---|\n| `register_agent` | Register an agent with a priority weight and initial token budget. |\n| `record_spend` | Record raw input/output tokens an agent consumed for a task. Automatically triggers priority-weighted reallocation if the agent goes over budget. |\n| `get_remaining_budget` | Look up one agent's current remaining budget, priority, and reserve. |\n| `request_reallocation` | **The core tool.** Given an agent that needs more tokens right now, runs the real priority-weighted borrowing logic and returns a concrete plan: which agents gave up how much, which agent received it, and why each donor was eligible. |\n| `get_budget_snapshot` | Full current state of every r…","publisher":{"name":"Swaranshu Borgaonkar","url":null},"homepage":"https://github.com/swaranshu-borgaonkar/tbcontracts-mcp","repository":"https://github.com/swaranshu-borgaonkar/tbcontracts-mcp","version":"0.1.0","license":null,"protocols":["mcp"],"tags":["agents","budget","llm","mcp","model-context-protocol","multi-agent","orchestration","reallocation","tokens"],"pricing":null,"endpoints":[{"url":"pypi:tbcontracts-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"automation.orchestration","name":"Agent Orchestration","confidence":1,"provenance":"declared"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.825,"provenance":"derived"}],"categories":["automation","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"tbcontracts-mcp","registry":"pypi","observedAt":"2026-10-28T23:22:26.943Z","publishedAt":"2026-08-12T23:12:30.770380Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"tbcontracts-mcp","url":"https://pypi.org/project/tbcontracts-mcp/","firstSeenAt":"2026-09-10T13:21:00.830Z","fetchedAt":"2026-10-28T23:22:02.755Z","normalizedAt":"2026-10-28T23:22:02.755Z"}]},"firstSeenAt":"2026-09-10T13:21:00.830Z","updatedAt":"2026-10-28T23:22:26.943Z"}