bitroad — Claude Code MCP server: agent purchases
bitroad gives an agent access to a goods and services marketplace, where it can search listings, place orders, and manage returns or disputes. You set the spending limits.
claude mcp add --transport http bitroad https://app.bitroad.ai/api/v1/mcpWhat bitroad does
With bitroad, an agent can search marketplace listings, inspect orders, start purchases, follow delivery, request returns, and file disputes. For work services, it can request a quote; payment stays in escrow until you accept the deliverable.
Connect Claude Code over HTTP, complete OAuth approval, then create a buyer account. To enable purchases, add a card and set caps for each transaction, daily spending, and total spending. Without those settings, the agent has no purchase path. It never receives card details.
A product purchase takes two calls: the first reserves stock and records the price, tax, and shipping; the next confirms payment and creates the order. Purchase intents expire after 15 minutes. Buyer and seller accounts are separate, so buyer accounts cannot use tools with the seller_ prefix.
What it helps with
- search marketplace listings for goods and services
- place orders within configured spending caps
- check order and delivery status
- start returns or submit disputes
- request a service quote and accept its deliverable
Example prompts for the agent
- Find desk lamps in the catalogue and show me the prices.
- Check my orders and tell me the delivery status.
- Start a return for order
ORDER_ID.
How to install bitroad
Platform CLI: remote server
claude mcp add --transport http bitroad https://app.bitroad.ai/api/v1/mcpPlatform CLI: remote server
codex mcp add bitroad --url https://app.bitroad.ai/api/v1/mcpConfig file
{
"mcpServers": {
"bitroad": {
"url": "https://app.bitroad.ai/api/v1/mcp"
}
}
}Config file
{
"servers": {
"bitroad": {
"type": "http",
"url": "https://app.bitroad.ai/api/v1/mcp"
}
}
}Platform CLI: remote server
gemini mcp add -t http bitroad https://app.bitroad.ai/api/v1/mcpStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about bitroad
How do I install bitroad in Claude Code?
Run claude mcp add --transport http bitroad https://app.bitroad.ai/api/v1/mcp, start Claude Code, and approve the OAuth request on the Bitroad consent screen.
What does bitroad do?
It connects an AI agent to a marketplace for goods and services. The agent can search listings, place capped orders, and manage delivery, returns, and disputes.
What must I set up before the agent can spend?
Create a buyer account, add a card, and configure spending caps in the dashboard. Card details remain hidden from the agent.
