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

#budget #cost-control #spend-cap #rate-limit #ai-agents #idempotency #x402 #governance

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

Frequently asked questions

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

Comments

Basic information

More AI & Agents MCP servers

21st.dev Magic AI Agent

21st-dev

It's like v0 but in your Cursor/WindSurf/Cline. 21st dev Magic MCP server for working with your frontend like Magic

5.3K

🛡️ A.I.G（AI-Infra-Guard）

Tencent

A full-stack AI Red Teaming platform securing AI ecosystems via OpenClaw Security Scan, Agent Scan, Skills Scan, MCP scan, AI Infra scan and LLM jailbreak evaluation.

4.1K