MCP server for AI agent payments — spending firewall, budget checks, and approval flows via the Model Context Protocol
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"bonanza-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# 💳 Bonanza MCP > **MCP server for AI agent payments — spending firewall, budget checks, and approval flows** [](https://pypi.org/project/bonanza-mcp/) [](https://pypi.org/project/bonanza-mcp/) [](LICENSE) [](https://modelcontextprotocol.io/) [](https://github.com/x402-foundation/x402) Use Bonanza's spending firewall directly from Claude, GPT, or any MCP-compatible AI agent. Check budgets, evaluate payments, approve spending, and audit transactions — all through natural language. ## Why? AI agents are making payments, but they need guardrails. Bonanza MCP brings our [spending firewall](https://github.com/c6zks4gssn-droid/bonanza-labs-website/tree/main/packages/x402-adapter) to the [Model Context Protocol](https://modelcontextprotocol.io/) — the standard way AI models interact with tools. Instead of writing custom code, your AI agent can simply call: > "Check if I can pay $5.00 for weather data" > "What's my remaining budget?" > "Approve payment to api.premium-data.com" > "Show my spending history" ## Installation ```bash pip install bonanza-mcp ``` With x402 protocol support: ```bash pip install bonanza-mcp[x402] ``` ## Quick Start ### 1. Configure Claude Desktop Add to your `claude_desktop_config.json`: ```json { "mcpServers": { "bonanza": { "command": "bonanza-mcp", "args": ["--max-budget", "10.00", "--require-approval-above", "5.00"] } } } ``` ### 2. Use in conversation ``` You: Check my budget Claude: Your current spending is $2.50 out of $10.00 (25%). You have $7.50 remaining. You: Can I pay $3.00 for API data from weather.com? Claude: ✅ Payment approved: $3.00 to weather.com Reason: All checks passed Risk level: L…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.