Budget Governor
@mightbesaad
About Budget Governor
Budget & cost control for AI agents: hard per-agent spend caps, rate limits, idempotency, and human-in-the-loop approval — enforced before each LLM call, not after the invoice. One hosted MCP endpoint (no proxy or self-hosting), settled via x402 (USDC on Base).
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"gvnr": {
"url": "https://gvnr.dev/mcp",
"headers": {
"Authorization": "Bearer YOUR_GVNR_API_KEY"
}
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is Budget Governor?
Budget Governor is a hosted MCP server that enforces spend caps, rate coordination, idempotency, and a human‑in‑the‑loop gate for AI agents – enforced before the LLM call, not after the invoice. It integrates via one MCP endpoint and settles using x402 (USDC on Base). It is built for developers running AI agents who need cost controls without self‑hosting proxy infrastructure.
How to use Budget Governor?
Add the MCP URL https://gvnr.dev/mcp?api_key=bg_YOUR_KEY to any MCP‑compatible client. Provision an account via POST /v1/account (includes 25 free trial ops), top up your governance‑operation quota with USDC, set a spend envelope per agent, then call budget_clear before each LLM request and reconcile after.
Key features of Budget Governor
- Pre‑call spend clearance against a per‑agent USD envelope
- Independent governance‑operation quota (1,000 ops per $1 USDC)
- Per‑(agent, provider, model) rate limiting with retry‑after hint
- Request‑level idempotency deduplication for retry safety
- Human‑in‑the‑loop approval flow with polling API
- No proxy – tokens never pass through the server
Use cases of Budget Governor
- Prevent runaway agent costs by capping daily or per‑session spend
- Coordinate request rates across multiple agents sharing a model provider
- Deduplicate retried LLM calls to avoid double billing
- Pause execution for human approval on high‑value or sensitive actions
- Meter and bill agent usage with a pay‑as‑you‑go governance quota
FAQ from Budget Governor
What does Budget Governor NOT do?
Budget Governor is not an LLM proxy – your tokens never pass through it, and you pay your model provider directly. It governs only the decision to spend.
What are the runtime requirements?
No self‑hosting, infrastructure, or proxy to deploy. It is a hosted endpoint accessible via HTTP.
Where does data live?
All state (op quota, envelopes, approvals) is managed server‑side on gvnr.dev infrastructure. Your API key is the credential.
What transports and auth are supported?
HTTP with Bearer token (API key) for both REST and MCP. The MCP endpoint uses the URL https://gvnr.dev/mcp?api_key=bg_YOUR_KEY.
How does
More AI & Agents MCP servers
MCP Manager for Claude Desktop
zueaisimple web ui to manage mcp (model context protocol) servers in the claude app
Just Prompt - A lightweight MCP server for LLM providers
dislerjust-prompt is an MCP server that provides a unified interface to top LLM providers (OpenAI, Anthropic, Google Gemini, Groq, DeepSeek, and Ollama)
meGPT - upload an author's content into an LLM
adriancoCode to process many kinds of content by an author into an MCP server
Mcp Agent
lastmile-aiBuild effective agents using Model Context Protocol and simple workflow patterns
Unreal Engine Generative AI Support Plugin
prajwalshettydevUnreal Engine plugin for LLM/GenAI models & MCP UE5 server. OpenAI GPT-5, Deepseek R1, Claude Opus/Sonnet, Gemini 3, Grok 4, Alibaba Qwen, Kimi, ElevenLabs TTS, Inworld, OpenRouter, Groq, GLM, Ollama, Local, Meshy, Tripo, Hunyuan3D, Rodin, fal, Dashscope, Seedream. NPC AI, agenti
Comments