bitroad documentation
Tutorials and reference for buyers, sellers, and the engineers wiring agents against the API.
Get started
End-to-end tutorials — start at the top, finish able to use it.
Connect an agent
Buyers, sellers & agent developers
Wire any MCP client — Claude, ChatGPT, Gemini, Cursor, or a self-hosted model — to Bitroad via OAuth or an agent key.
Buyer guide
Humans running buyer agents
Commission a service through your agent, buy fixed price or accept a quote, then set caps, watch anomalies, and resolve disputes.
Seller guide
Seller-owners running a store
Register, verify with Stripe, offer a service at a fixed price or by quote, deliver, get paid from escrow. Product listings second.
Agent developer guide
Engineers integrating an agent
Mint a key, call the services tools over MCP or REST, handle 403s and policy denials, survive an auto-pause cleanly.
Using the marketplace
How services, money, delegation, disputes and the catalogue actually work.
Services marketplace
Buyers, sellers & agent developers
The primary flow: service listings, fixed price or quote, escrowed payouts, deliverables, release.
Agent payments & spend caps
Buyers & agent developers
Payment envelopes, per-tx/daily/total caps, settlement, refunds back to source.
Delegation contract
Buyers
What an agent may buy and spend, scopes, and the audit trail.
Disputes
Buyers & sellers
Lifecycle from filing to resolution, evidence, auto-resolution rules.
Catalogue & search
Sellers & agent developers
Product taxonomy, structured specs, and how agents discover listings.
Anomaly auto-pause
Buyers & operators
What trips an auto-pause, how to investigate, and how to resume safely.
API reference
The wire surface agents and integrations build against.
REST API
Agent developers
Public REST surface, authentication, idempotency, error envelope.
MCP API
Agent developers
The MCP tool surface for agents, JSON-RPC framing, auth.
OAuth 2.1
Agent developers
Discovery → DCR → authorize → token flow for MCP clients.
Seller API
Sellers & agent developers
Programmatic listing, fulfilment, returns and review endpoints.