# bitroad

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: bitroadai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bitroadai/bitroad-mcp
- Updated: 2026-09-07
- HTML: https://affpapa.org/en/nevibecode/mcp/bitroad

## What it 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.

## Requirements
- Remote server: `https://app.bitroad.ai/api/v1/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http bitroad https://app.bitroad.ai/api/v1/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add bitroad --url https://app.bitroad.ai/api/v1/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "bitroad": {
            "url": "https://app.bitroad.ai/api/v1/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "bitroad": {
            "type": "http",
            "url": "https://app.bitroad.ai/api/v1/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http bitroad https://app.bitroad.ai/api/v1/mcp
```

## When to use it
- 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
- 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`.

## Similar
- [mcp](https://affpapa.org/en/nevibecode/mcp/fluf-io-mcp.md) — MCP server · ★ 1
- [app-marketplace-monetization-model](https://affpapa.org/en/nevibecode/skills/app-marketplace-monetization-model.md) — skill · 8100 installs
- [connect-recommend](https://affpapa.org/en/nevibecode/skills/connect-recommend.md) — skill · ★ 7624
- [mcp-zoop](https://affpapa.org/en/nevibecode/mcp/mcp-zoop.md) — MCP server · ★ 275
- [mcp-getnet](https://affpapa.org/en/nevibecode/mcp/mcp-getnet.md) — MCP server · ★ 275
- [okx-cex-trade](https://affpapa.org/en/nevibecode/skills/okx-cex-trade.md) — skill · 10300 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md