Add it to Claude Code
claude mcp add mcp-billing-spec -- npx @forthebots/bazaar-sdkMake your agent remember this setup
mcp-billing-spec's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Per-call billing with sub-cent precision
- Signed receipts using HMAC-SHA256 for tamper-proof verification
- Standardized pricing declarations for per-call and per-token models
- Trust scores based on provider verification and SLA monitoring
- Integrated dispute resolution status flow
Try it
Original README from TombStoneDash/mcp-billing-spec
MCP Billing Spec v1
An open standard for billing, metering, receipts, verification, and dispute resolution in MCP tool ecosystems.
Why This Exists
There are 10,000+ MCP servers but most are hobby-quality because developers can't earn from them. Multiple companies are building billing solutions independently with incompatible schemas. This fragmentation hurts everyone:
- Agents must learn different billing APIs per provider
- Providers can't switch billing platforms without rewriting integrations
- Platforms compete on implementation details instead of value
This spec creates a common language for MCP billing.
Quick Start
Want to monetize your MCP server? → Provider Quickstart Guide (5 minutes)
Want to use paid MCP tools? → Consumer Quickstart (3 minutes)
Want to implement the spec? → Read mcp-billing-v1.md
What It Covers
| Section | Description |
|---|---|
| Meter Events | Standard schema for recording tool invocations |
| Signed Receipts | HMAC-SHA256 tamper-proof proof of every call |
| Pricing Declarations | How providers declare per-call and per-token pricing |
| Verification Levels | 4-tier provider verification (unverified → email → domain → code) |
| Dispute Resolution | Filing, status flow, resolution types |
| Trust Scores | Composite scoring from verification + SLA + disputes |
Read the Spec
📄 mcp-billing-v1.md — The full specification
🌐 noui.bot/specs/mcp-billing-v1 — Web version
Reference Implementation
The Agent Bazaar at noui.bot is the reference implementation:
- API:
https://noui.bot/api/v1(v0.4.0) - Provider Guide: noui.bot/docs/guides/provider-quickstart
- SDK:
npm install @forthebots/bazaar-sdk - OpenAPI:
https://noui.bot/api/openapi.json - Source: github.com/TombStoneDash/noui-bot
Key Features
- Per-call billing with sub-cent precision ($0.001 minimum)
- 82% revenue share for providers (18% platform fee)
- Signed receipts (HMAC-SHA256) on every transaction
- Trust scores with verified provider badges
- Dispute resolution with full status flow
- Zero code changes — proxy to existing MCP servers
Competitive Landscape
See how Agent Bazaar compares to other approaches: noui.bot/docs/compare
| Platform | Status | Trust Layer | Open Standard |
|---|---|---|---|
| Agent Bazaar | Live | ✅ v0.4.0 | ✅ This spec |
| xpay | Live | ❌ | ❌ |
| TollBit | Pre-launch | ❌ | ❌ |
| MCP Hive | Pre-launch (Mar 8) | ❌ | ❌ |
For Other Billing Providers
This spec is designed to be implementable by anyone — including our competitors. If you're building MCP billing (xpay, TollBit, MCP Hive, or something new), you can:
- Implement the receipt schema — agents get consistent billing experiences regardless of provider
- Use the verification levels — a shared trust vocabulary for the ecosystem
- Adopt the dispute schema — standard resolution flow across platforms
- Reference this spec — and contribute to making it better
We'd rather be the reference implementation of a universal standard than a walled garden.
Contributing
- Open an issue for spec feedback, clarifications, or proposed changes
- PRs welcome for typos, examples, and additional appendices
- Major schema changes should go through an issue discussion first
License & Patent Pledge
This specification is released under MIT. No contributor may assert patents against implementations of this specification. This commitment is irrevocable.
Copy it. Fork it. Implement it. That's the point.
Built by TombStone Dash LLC · San Diego, CA One human, one AI. The void is open.