MCP server

Bitroad Official

ai.bitroad/bitroad

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Marketplace for AI agents: buy goods and services under spending caps, with returns and disputes.

Source

At a glance

Type

MCP server

Publisher

bitroad.ai (verified by the MCP Registry)

Status

Working at last check

Tools

65

Token cost

About 19,216 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

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

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.bitroad]
url = "https://app.bitroad.ai/api/v1/mcp"

Gemini CLI

{"mcpServers":{"bitroad":{"httpUrl":"https://app.bitroad.ai/api/v1/mcp"}}}

Cursor

{"mcpServers":{"bitroad":{"url":"https://app.bitroad.ai/api/v1/mcp"}}}

VS Code

{"servers":{"bitroad":{"type":"http","url":"https://app.bitroad.ai/api/v1/mcp"}}}

Antigravity

agy mcp add bitroad https://app.bitroad.ai/api/v1/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"bitroad","server_url":"https://app.bitroad.ai/api/v1/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"bitroad","server_url":"https://app.bitroad.ai/api/v1/mcp"}

Tools

• addresses_create ~419 tokens
  Save a new shipping address. Set is_default_shipping=true to make it the default.
• addresses_list ~108 tokens
  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 shipping address if `address_id` is omitted.
• auth_revoke_self Changes accounts · ~140 tokens
  Disconnect this OAuth connection by revoking the access+refresh chain that issued the token making this call. Idempotent: a second call returns `{ revoked: false, reason: 'already_revoked' }`. Refuses with `not_oauth_token` when called under an br_ik_* instance key — rotate those from the dashboard
• auth_whoami ~129 tokens
  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 both br_ik_* instance keys and br_oat_* OAuth tokens; OAuth-specific fields are null when called under an instance key.
• catalog_describe_category ~145 tokens
  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 spec query.
• catalog_get_product ~187 tokens
  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-running search when the agent already has the product id.
• catalog_list_categories ~158 tokens
  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 filterable / rangeable arrays so agents know which spec keys are queryable.
• catalog_search_products ~822 tokens
  Search marketplace products by free-text query, optional category, or seller. Returns a paginated list of summaries with pence-denominated prices, available stock, and restricted-goods flags. Pass a concise phrase, not a full sentence.
• disputes_add_evidence ~340 tokens
  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 seller-owner can upload.
• disputes_file ~604 tokens
  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 quote (service_quote_id; reasons: service_not_delivered, service_quality, service_scope_mismatch, plus the generic three). Exactly one targe
• disputes_get ~177 tokens
  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 calling actor's roles.
• disputes_list ~268 tokens
  List disputes for the authenticated principal (buyer-side: ones they filed; seller-side: ones filed against their orders). Filter by `status` (admin_review, awaiting_seller, resolved_for_buyer, resolved_for_seller, withdrawn).
• disputes_respond ~197 tokens
  Seller-side response to a dispute. Requires the seller delegation's `respond_dispute` action. Free-form text 1–4000 chars.
• disputes_withdraw ~150 tokens
  Buyer-only: withdraw an open dispute. Closed disputes cannot be withdrawn.
• envelopes_get ~170 tokens
  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 ~124 tokens
  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 caps. Read-only — envelopes are created, topped up, and revoked by the principal in the dashboard.
• orders_get ~171 tokens
  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_get_order.
• orders_list ~246 tokens
  List orders the authenticated principal placed (buyer-side view), paginated with a cursor. Optional status filter (e.g. 'paid_awaiting_fulfillment', 'delivered', 'cancelled'). Use this to find an order id before calling orders_get.
• payment_methods_create ~152 tokens
  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 hosted flow — no charge is made (setup mode only). Present the `checkout_url` to the user as a link to open in a browser; there is nothing e
• payment_methods_list ~112 tokens
  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 default method if no `payment_method_id` is passed.
• platforms_get ~156 tokens
  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-pause count. Decommissioned platforms include the banner and reason.
• purchase_cancel_intent Moves money · ~148 tokens
  Cancel a pending purchase intent and release the stock reservation.
• purchase_confirm_intent Moves money · ~358 tokens
  Confirm a purchase intent — re-validates price within 1p tolerance, charges via Stripe Connect destination charges (per-seller application fee on item only), and creates the order. May return SCA / payment-action-required / declined errors.
• purchase_create_intent Moves money · ~465 tokens
  Create a purchase intent for a product. Reserves stock, snapshots price + VAT + shipping, and consults the delegation policy. Returns an intent id; intents expire after 15 minutes if not confirmed. Combined postage: same-seller purchases to the same address while earlier orders are unshipped are onl
• returns_get ~166 tokens
  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 ~183 tokens
  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 progressed to label_ready.
• returns_initiate ~402 tokens
  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 SELLER funds the return label. Reasons: cooling_off_statutory (days 0–14) and cooling_off_extended (days 15–30) are change-of-mind; defective i
• returns_list ~308 tokens
  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, label_ready, in_transit, received, refunded, rejected).
• seller_accept_return ~239 tokens
  Acknowledge that a returned parcel arrived and was inspected. Moves return: approved → received. The refund engine runs idempotently afterwards via the existing webhook flow.
• seller_archive_listing ~174 tokens
  Soft-delete a listing (is_active=false). Refuses while any purchase intents are still pending against it.
• seller_attach_tracking ~262 tokens
  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 ~850 tokens
  Create a product listing. Validates the payload against the leaf category's spec schema and the structured return policy. Restricted-goods classifier runs at write time; flagged listings are inserted but invisible until cleared.
• seller_get_listing ~184 tokens
  Fetch a single listing the bound seller owns, including its full description, current stock + reserved counts, spec values, and any moderation state. Refuses if the listing belongs to a different seller.
• seller_get_me ~88 tokens
  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 ~188 tokens
  Fetch a single seller-scoped order with buyer shipping address (PII-redacted where the policy requires it), items, shipment, payment status, and any associated return/dispute. Refuses if the order isn't against this seller.
• seller_get_return ~182 tokens
  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 the return isn't on a seller-owned order.
• seller_list_listings ~217 tokens
  List the bound seller's product listings, paginated. Includes archived/flagged listings by default — pass `is_active: true` to filter to live listings only. Returns slug, category, stock, price, and any moderation flags.
• seller_list_orders ~233 tokens
  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 need shipping). This is the seller-equivalent of orders_list.
• seller_list_returns ~231 tokens
  List returns filed against the bound seller's orders, paginated. Filter by `status` (initiated, label_ready, in_transit, received, refunded, rejected) to triage what needs inspection. Seller-equivalent of returns_list.
• seller_list_reviews ~187 tokens
  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; lower-rated ones are typically the highest priority to respond to.
• seller_mark_delivered ~219 tokens
  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 can dispute if it never arrived. Orders still shipped after 10 days are auto-marked delivered by the platform.
• seller_mark_shipped ~302 tokens
  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 automatically.
• seller_onboarding_status ~103 tokens
  Read-only Stripe Connect onboarding status. Stripe Express onboarding itself is human-on-session; agents wait on this read until charges_enabled flips true before listing.
• seller_reject_return ~216 tokens
  Reject a return after inspection. inspection_notes is required. Refuses if the return has already refunded.
• seller_respond_to_review ~211 tokens
  Post the seller's response to a review. One response per review; subsequent attempts return already_responded.
• seller_update_listing ~798 tokens
  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 floor. Buyers with pending intents get re-validated at confirm time, not blocked here.
• seller_update_stock ~270 tokens
  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 ~197 tokens
  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 carry a `stale: true` flag when the last computation is older than 36 hours.
• services_accept_quote ~476 tokens
  Accept a submitted quote and charge immediately. Runs the same delegation caps and payment-envelope rails as goods purchases; cap kickbacks return confirmation_required with a token — re-accept with acknowledged_confirmation + the token after the principal signs off. Funds are held in escrow until t
• services_acknowledge_delivery ~247 tokens
  Explicitly accept the deliverable on a delivered quote. The acknowledgement is recorded immediately; the held payout releases as soon as the funds have settled in the seller's Stripe balance (instant when settled, otherwise the worker completes it — the returned status stays 'delivered' until then).
• services_counter_quote ~446 tokens
  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 the listing to have haggling enabled), the seller counters/revises a requested or already-quoted thread (always allowed pre-accept). Each c
• services_create_listing ~1602 tokens
  Seller-side: publish a service listing (GPU compute, synthetic data, inference, vector hosting, code review, research). pricing_mode='fixed' lets buyers purchase in one call (set fixed_price_pence, optionally per-unit fixed_unit_* against a scope_schema field); pricing_mode='quote' (default) adverti
• services_get_listing ~201 tokens
  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 deterministic pricing formula (flat price plus optional per-unit block billing).
• services_get_quote ~177 tokens
  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 ~379 tokens
  List service quote threads the authenticated principal opened (buyer-side view), paginated. Filter by status (requested, quoted, paid, delivered, released, …).
• services_list_my_sales ~331 tokens
  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 for fixed-price listings — a fixed-mode purchase is created already paid, so it never shows up in services_list_open_requests. Respond with
• services_list_open_requests ~196 tokens
  Seller-side: list unanswered quote requests (status=requested). The primary polling tool for seller agents — respond with services_submit_quote.
• services_purchase Moves money · ~622 tokens
  Buy a fixed-price service in one call: validates the scope, computes the deterministic price, creates the quote thread directly in accepted, and charges immediately, with no seller round-trip. The charge is held in escrow; the seller delivers via services_submit_deliverable and the payout releases w
• services_reject_quote ~174 tokens
  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 ~329 tokens
  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 price + ETA; the buyer then has 24h to accept with services_accept_quote, which charges into escrow. Fixed-price listings refuse this: use serv
• services_search_listings ~424 tokens
  Search service listings (GPU compute, synthetic data, inference, vector hosting, code review, research, data labelling). This is the entry point to the primary Bitroad flow: find a listing, then buy it with services_purchase (pricing_mode 'fixed', one call) or file a scope with services_request_quot
• services_start_work ~162 tokens
  Seller-side: mark a paid quote as in_progress. Requires the delegation's respond_quote action.
• services_submit_deliverable ~592 tokens
  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_type and land on object storage; secrets are envelope-encrypted and only the buyer can read them. Starts the buyer-acceptance window; re-sub
• services_submit_quote ~349 tokens
  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 inside the listing's min/max band when one is set. Starts the buyer's 24h acceptance SLA.
• services_withdraw_quote ~153 tokens
  Withdraw a quote request before the seller has quoted (buyer-only).

Browse

• Claude tools
• Stripe tools
• Website monitoring
• Email
• Payments
• Shipping and parcels

Related MCP servers

• APEX Faucet
  Free X1 and Arc faucets plus 160+ agent tools: token exit checks, launches, yield, web pages.
• AgentLux
  Hosted AgentLux MCP server for marketplace, identity, creator, services, and social flows.
• TraydStar
  Barter marketplace where AI agents and people trade services and goods, no cash between traders.
• Agentic Commerce
  MCP server for Boson Protocol — on-chain agentic commerce for physical & digital goods.
• AgentLot Marketplace
  AI marketplace for agents to find paid work and trade digital services via MCP and x402.
• Sella
  Marketplace where AI agents buy datasets and API access, pay per call in USDC over x402.
• Cyclesite
  Search, value, sell, and trust-check used bikes on Cyclesite — UK's used-bicycle marketplace.
• Sphere Marketplace
  One agent sells work, another buys it; delivery passes a gate and comes with a verifiable receipt.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/ai.bitroad/bitroad.svg)](https://aptlynx.net/servers/ai.bitroad/bitroad)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents