# Bitroad MCP server

Source: https://glimind.com/server/mcp-registry%2Fai.bitroad%2Fbitroad
Registry id: `mcp-registry/ai.bitroad/bitroad`
Status: live (checked 2026-10-26T20:36:39.307Z)

## Measurements (30 days)

- Uptime: 99.76%
- Checks: 4645
- Outages (90 days): 4

## Install

```json
{
  "mcpServers": {
    "bitroad-mcp-server": {
      "type": "http",
      "url": "https://app.bitroad.ai/api/v1/mcp"
    }
  }
}
```

Claude Code:

```sh
claude mcp add --transport http bitroad-mcp-server https://app.bitroad.ai/api/v1/mcp
```

## Tools (67)

- `addresses_create`: Save a new shipping address. Set is_default_shipping=true to make it the default.
- `addresses_list`: List the principal's saved shipping addresses. The agent does NOT need to call this every purchase — purchase_create_intent will use the principal's default shi
- `auth_revoke_self`: Disconnect this OAuth connection by revoking the access+refresh chain that issued the token making this call. Idempotent: a second call returns `{ revoked: fals
- `auth_whoami`: Return who this MCP credential acts as: principal email/role, agent name, client (Claude install) that issued the token, and when it was last used. Works for bo
- `catalog_describe_category`: Fetch one category by slug, including the spec JSON Schema for leaf categories. Useful before building a structured purchase intent so the agent emits a valid s
- `catalog_get_product`: Fetch a single product by id. Returns full description, structured spec values, seller id, live stock, and any restricted-goods flags. Prefer this over re-runni
- `catalog_list_categories`: List the marketplace's category taxonomy. Optionally pass `slug` to scope to a subtree (e.g. 'electronics'). Each leaf carries its JSON Schema for specs, plus f
- `catalog_search_products`: Search marketplace products by free-text query, optional category, or seller. Returns a paginated list of summaries with pence-denominated prices, available sto
- `disputes_add_evidence`: Attach an evidence item to an open dispute. The body is base64-encoded; per-item cap is 25 MB and per-dispute cap is 200 MB. Either the filing buyer or the sell
- `disputes_file`: File a dispute on a goods order (order_id; reasons: not_as_described, defective, not_received, fraud_unauthorized_charge, duplicate_charge, other) or a service 
- `disputes_get`: Fetch one dispute by id with the full evidence trail and timeline. Buyer-side or seller-side caller — returns 404 if the dispute doesn't belong to either of the
- `disputes_list`: List disputes for the authenticated principal (buyer-side: ones they filed; seller-side: ones filed against their orders). Filter by `status` (admin_review, awa
- `disputes_respond`: Seller-side response to a dispute. Requires the seller delegation's `respond_dispute` action. Free-form text 1–4000 chars.
- `disputes_withdraw`: Buyer-only: withdraw an open dispute. Closed disputes cannot be withdrawn.
- `envelopes_get`: Fetch a single envelope by id. Returns the same shape as envelopes_list. Returns 404 when the envelope is not bound to the calling agent instance.
- `envelopes_list`: List the active and historical payment envelopes the calling agent instance can draw against. Each entry shows balance, scope, validity, and per-tx / per-day ca
- `orders_get`: Fetch a single order with line items, shipment / tracking, payment status, and any associated returns or disputes. Buyer-side view — for seller-side use seller_
- `orders_list`: List orders the authenticated principal placed (buyer-side view), paginated with a cursor. Optional status filter (e.g. 'paid_awaiting_fulfillment', 'delivered'
- `payment_methods_create`: Returns a one-time Stripe Checkout URL to hand the user so they can add a payment card. The card is saved to their account automatically when they complete the 
- `payment_methods_list`: List the principal's saved payment methods (last4 + brand only — full card numbers are never exposed to agents). purchase_confirm_intent uses the principal's de
- `platforms_get`: Fetch a platform's public reputation profile by slug: KYC status, rolling-window orders/disputes/refunds, on-time-ship rate, dispute resolution p50/p95, anomaly
- `purchase_cancel_intent`: Cancel a pending purchase intent and release the stock reservation.
- `purchase_confirm_intent`: Confirm a purchase intent — re-validates price within 1p tolerance, charges via Stripe Connect destination charges (per-seller application fee on item only), an
- `purchase_create_intent`: Create a purchase intent for a product. Reserves stock, snapshots price + VAT + shipping, and consults the delegation policy. Returns an intent id; intents expi
- `returns_get`: Fetch a single return by id, including reason, status, restocking fee (if any), refund ledger, and the inspection trail once the parcel has arrived.
- `returns_get_label`: Fetch a short-lived signed URL for the return shipping label PDF. URL expires within minutes; re-call to get a fresh one. Only available once the return has pro
- `returns_initiate`: Initiate a return on a delivered order. Uniform platform policy: a 30-day change-of-mind window from delivery, FREE, full refund, NO restocking fee, and the SEL
- `returns_list`: List returns the authenticated principal filed (buyer-side view), paginated. Filter by `order_id` to find returns on a specific order, or by `status` (initiated
- `seller_*`: Seller tools for listings, stock, orders, shipping, returns, and review responses
- `seller_accept_return`: Acknowledge that a returned parcel arrived and was inspected. Moves return: approved → received. The refund engine runs idempotently afterwards via the existing
- `seller_archive_listing`: Soft-delete a listing (is_active=false). Refuses while any purchase intents are still pending against it.
- `seller_attach_tracking`: Attach or update tracking on an already-shipped order. Use mark_shipped for first ship; this is for late-arriving tracking only.
- `seller_create_listing`: Create a product listing. Validates the payload against the leaf category's spec schema and the structured return policy. Restricted-goods classifier runs at wr
- `seller_get_listing`: Fetch a single listing the bound seller owns, including its full description, current stock + reserved counts, spec values, and any moderation state. Refuses if
- `seller_get_me`: Fetch the seller record bound to the calling principal or seller-side agent instance. Refuses when the caller has no seller record.
- `seller_get_order`: Fetch a single seller-scoped order with buyer shipping address (PII-redacted where the policy requires it), items, shipment, payment status, and any associated 
- `seller_get_return`: Fetch a single return filed against one of the bound seller's orders, with reason, status, restocking fee, inspection notes, and the refund ledger. Refuses if t
- `seller_list_listings`: List the bound seller's product listings, paginated. Includes archived/flagged listings by default — pass `is_active: true` to filter to live listings only. Ret
- `seller_list_orders`: List orders placed against the bound seller's products (seller-side view), paginated. Filter by `status` (e.g. 'paid_awaiting_fulfillment' to find orders that n
- `seller_list_returns`: List returns filed against the bound seller's orders, paginated. Filter by `status` (initiated, label_ready, in_transit, received, refunded, rejected) to triage
- `seller_list_reviews`: List reviews left on this seller's orders, paginated. Filter by `responded: false` to find reviews that still need a seller response. A review's `rating` is 1-5
- `seller_mark_delivered`: Declare a shipped order as delivered (no carrier confirmation is wired). Only valid from shipped; already-delivered is a no-op success. Notifies the buyer, who 
- `seller_mark_shipped`: Mark an order as shipped with a tracking number. Idempotent on (order_id, tracking_number) — same pair is a no-op success. Enqueues carrier polling automaticall
- `seller_onboarding_status`: Read-only Stripe Connect onboarding status. Stripe Express onboarding itself is human-on-session; agents wait on this read until charges_enabled flips true befo
- `seller_reject_return`: Reject a return after inspection. inspection_notes is required. Refuses if the return has already refunded.
- `seller_respond_to_review`: Post the seller's response to a review. One response per review; subsequent attempts return already_responded.
- `seller_update_listing`: Patch an existing listing the calling seller owns. Specs are re-validated against the leaf schema; return_policy is re-validated against the platform statutory 
- `seller_update_stock`: Update a listing's stock count. Pass `stock` for an absolute value or `delta` for a relative change. Resulting stock must remain >= reserved.
- `sellers_get`: Fetch a seller's public profile + trust signals (verification tier, dispute / refund / on-time-ship rates over a 90-day window, response times). Trust metrics c
- `services_*`: Services tools for quote-based marketplace
- `services_accept_quote`: Accept a submitted quote and charge immediately. Runs the same delegation caps and payment-envelope rails as goods purchases; cap kickbacks return confirmation_
- `services_acknowledge_delivery`: Explicitly accept the deliverable on a delivered quote. The acknowledgement is recorded immediately; the held payout releases as soon as the funds have settled 
- `services_counter_quote`: Post a counter-offer on a quote thread (price in pence, ETA in minutes, optional terms). Either side may counter: the buyer counters a submitted quote (requires
- `services_create_listing`: Seller-side: publish a service listing (GPU compute, synthetic data, inference, vector hosting, code review, research). pricing_mode='fixed' lets buyers purchas
- `services_get_listing`: Fetch a single service listing including its scope schema — the fields a quote request or purchase scope must provide — and, for fixed-price listings, the deter
- `services_get_quote`: Fetch one service quote thread with its deliverables. Buyer or seller side. Secret deliverables are decrypted only for the buyer; everyone else sees a redaction
- `services_list_my_quotes`: List service quote threads the authenticated principal opened (buyer-side view), paginated. Filter by status (requested, quoted, paid, delivered, released, …).
- `services_list_my_sales`: Seller-side: list charged threads you still owe work on, paginated. status=paid | in_progress | delivered, or active (all three, the default). The polling tool 
- `services_list_open_requests`: Seller-side: list unanswered quote requests (status=requested). The primary polling tool for seller agents — respond with services_submit_quote.
- `services_purchase`: Buy a fixed-price service in one call: validates the scope, computes the deterministic price, creates the quote thread directly in accepted, and charges immedia
- `services_reject_quote`: Reject a submitted quote (buyer-only). Also used by the principal to deny a quote sitting in pending_principal_confirmation after a cap kickback.
- `services_request_quote`: File a scope-of-work against a quote-mode service listing for bespoke work. The scope must conform to the listing's scope schema. The seller responds with a pri
- `services_search_listings`: Search service listings (GPU compute, synthetic data, inference, vector hosting, code review, research, data labelling). This is the entry point to the primary 
- `services_start_work`: Seller-side: mark a paid quote as in_progress. Requires the delegation's respond_quote action.
- `services_submit_deliverable`: Seller-side: submit the deliverable on a paid/in-progress quote. kind=url|text|file|secret. Files are base64 in file_b64 (max 25 MB) with file_name + file_mime_
- `services_submit_quote`: Seller-side: answer a quote request with a price (pence), ETA in minutes, and optional terms. Requires the delegation's respond_quote action. Price must sit ins
- `services_withdraw_quote`: Withdraw a quote request before the seller has quoted (buyer-only).

Measured by Glimind (https://glimind.com): MCP handshake + tool list only, no tool is ever called. CC BY 4.0.