Skip to content
Bridge to Brands
Sign in

Enable your agents · MCP

Connect Claude or ChatGPT in two minutes

by RunOps

Pick your client, paste one thing, and your agent can browse every brand portal you connected. Need a key first? Get an API key; ChatGPT and Claude.ai can sign in with OAuth instead.

Setup

Paste your API key as a bearer header.

claude mcp add --transport http brdg2b https://mcp.brdg2b.ai/mcp \
  --header "Authorization: Bearer b2b_live_XXXXXXXX_..."

Add a custom connector; sign in with OAuth or use request headers.

Claude.ai / Claude Desktop -> Settings -> Connectors -> Add custom connector
  URL: https://mcp.brdg2b.ai/mcp
  either: Request headers -> Authorization: Bearer b2b_live_...   (if your org has the beta)
  or:     Sign in -> Google -> pick the key                       (OAuth)

Developer mode connector; OAuth only.

ChatGPT -> Settings -> Apps & Connectors -> Developer mode -> Add
  URL: https://mcp.brdg2b.ai/mcp
  Authentication: OAuth -> sign in -> pick the key

For your own agent on the Claude API.

"mcp_servers": [{
  "type": "url",
  "url": "https://mcp.brdg2b.ai/mcp",
  "name": "brdg2b",
  "authorization_token": "b2b_live_..."
}]

The Bridge to Brands MCP server at https://mcp.brdg2b.ai/mcp lets Claude, ChatGPT and any MCP client list brands, read live warehouse availability and dealer pricing, resolve UPCs in bulk, and place fill-in and drop-ship orders in brand dealer portals. Orders are placed only within the caps and confirmation you set, or staged for a person to review and place in Bridge. It accepts OAuth 2.1 or an API key, and meters every call to a key.

Tools

17 tools, generated from the server's own tool list.

ToolKindWhat it does
list_brands() read-only Lists every brand Bridge to Brands supports, whether this account has connected each brand's dealer portal, and what each brand can do.
list_accounts(brand?) read-only Lists the retailer's logins (accounts) per brand — a brand can have several, such as 'Retail stores' and 'Amazon FBA', each seeing different warehouses, prices, availability and ship-tos.
search_products(brand, query, account?, limit?, mode?, page?) read-only Searches one brand's dealer catalog by free text and returns matching styles with their colourways, images and dealer prices.
get_product(brand, style_id, account?) read-only Returns one style's colourways, size run, images and dealer prices.
get_availability(brand, style_id, account?, accounts?, color_id?) read-only Reads the brand's live availability grid — sizes × delivery windows with quantities — for one style (one colourway or all).
lookup_items(brand, items, account?) read-only Resolves up to 200 items — by UPC, SKU, style+colour+size or vendor variant id — to the brand's exact variant, with immediate availability, future windows and dealer price.
list_ship_tos(brand, account?) read-only Lists the account's stores as the brand's portal knows them — the destinations a fill-in can ship to.
place_order(brand, idempotency_key, kind, lines, po, ship_to_ref, account?, confirm?, consumer?, mode?, ship_dates?, terms_ack?) writes Stages an order as an UNSUBMITTED draft or basket in the brand's dealer portal and returns the links where the user reviews and submits it, or with mode `submit` places it with the brand where the brand and the account allow it.
submit_order(order_id, confirm?, ship_dates?, terms_ack?) writes (destructive) Places a staged order with the brand: the staged basket is read back, compared with the order and submitted exactly once.
cancel_order(order_id) writes (destructive) Asks the brand's portal to cancel every vendor order of a submitted order, where the brand allows cancelling.
get_order(order_id) read-only Returns one order — staged by brdg2b or read from the vendor's own order book — with its status, portal links, confirmed lines and shipments.
list_orders(account?, brand?, cursor?, limit?, since?, source?, status?) read-only Lists the account's orders, newest first: those staged through brdg2b and those in the vendors' own order books.
track_order(brand?, order_id?, po?, vendor_order_number?) read-only Returns the shipments of one order with carrier, tracking number and a tracking link per package.
refresh_order(order_id) read-only Re-reads one order from the brand's portal now and returns the updated order.
get_usage(group_by?, period?) read-only Returns the calling key's own usage — requests, results, orders, lines and units — for a period.
request_brand(name, portal_url, note?) writes Asks Bridge to Brands to build a connector for a brand that is not in list_brands.
list_brand_requests() read-only Lists this account's requests for new brands and their status.

Annotations come from the server: read tools carry readOnlyHint: true; every tool is openWorldHint: true because it calls third-party portals.

Authentication

  • API key: Authorization: Bearer b2b_live_<prefix>_<secret>, verified exactly as the REST API does.
  • OAuth 2.1: PKCE (S256), Dynamic Client Registration, scopes read and orders. Metadata at https://mcp.brdg2b.ai/.well-known/oauth-protected-resource.
  • Unauthenticated calls get 401 with WWW-Authenticate pointing at the resource metadata, so compliant clients discover the authorization server.

Frequently asked questions

What is the Bridge to Brands MCP server URL?

As of 16 October 2026, it is https://mcp.brdg2b.ai/mcp, using MCP Streamable HTTP with SSE as a fallback for older clients. One server serves every account; the credential decides which account a call acts on.

Does the MCP server accept API keys?

Yes. As of 16 October 2026, it accepts a bearer API key (Claude Code, the Claude Messages API, Claude.ai request headers where enabled) and OAuth 2.1 access tokens (ChatGPT, Claude.ai sign-in). OAuth tokens are bound to one of your API keys.

Can the agent submit an order to the brand?

Only where you allow it. As of 16 October 2026, place_order stages every order and places it only for brands whose submit path is verified, where the account has turned submitting on, the key has orders:submit and the call says confirm: true, within the account caps. Otherwise it stages the order for a person to review and place in Bridge, without signing in to the portal.

Related

Last updated