Open Commerce Protocol

Your store,
ready for the
agentic future.

Every Bareconnect store ships with a machine-readable API. AI agents, shopping bots, and developer platforms can browse products, create checkouts, and receive real-time notifications — no browser, no scraping, no custom integration.

Agent commerce · live demo
Agent · internal calls
GET /~/ucp/directory (847 stores)
GET /~/ucp/catalog?search=...
← 3 results matched · checkout ready
● Live
UCP icon

Core technology

Powered by the Universal Commerce Protocol

UCP on Bareconnect is built on the open specification co-developed by Google and Shopify — a shared standard that defines how AI agents discover stores, browse catalogs, and complete transactions. Every endpoint, response schema, and webhook format follows the spec. What you build here works anywhere the protocol is implemented.

Read the open specification at ucp.dev
+

Capabilities

Everything a shopping agent needs.

Store discovery

One endpoint lists every participating store with capabilities, payment methods, and catalog URLs. Paginated, always fresh.

Product catalog

Structured product data with pricing, availability, images, and variant IDs. Filter by keyword, price, or category in one call.

Checkout & payment

Create a session, attach a shipping address, and redirect the customer to payment. Supports all active payment methods.

Webhooks

HMAC-SHA256 signed events the moment a checkout is created, completed, or fails. Same security model as Stripe. Auto-retried.

LLM store summaries

Every store publishes a /llms.txt — a plain-text product summary designed to drop directly into an LLM context window.

MCP server

A native Model Context Protocol server lets Claude, GPT, and any MCP-compatible AI use tools like discover_stores and create_checkout as first-class actions.

How it works

From first request to placed order.

The full commerce lifecycle in four API calls. Click a step to see what the agent sends — and what your customer sees.

GET bareconnect.com/ucp/directory
Authorization: Bearer {platform_key}
← 200 OK
{
"stores": [
{
"name": "Luxuria's Fabrics",
"currency": "USD",
"products": 142
},
{
"name": "Kente Fashion",
"currency": "USD",
"products": 87
}
],
"total": 847
}

Store directory

Kuuku's Fabrics
142 products
UCP ✓
Volta Textiles
87 products
UCP ✓
Mode by Ama
63 products
UCP ✓

+ 844 more stores

GET ~/ucp/catalog
?searchq=lady+slippers&max_price=200
{
"items": [
{
"id": "ucp_prod_k7x",
"name": "Kente Smock",
"price": 175,
"currency": "USD",
"in_stock": true
}
]
}

Search results

Kente Smock
Kente Smock
Kuuku's Fabrics
175
Northern Batakari
Northern Batakari
Volta Textiles
190
Embroidered Smock
Embroidered Smock
Accra Threads
165
POST ~/ucp/checkout
{
"items": [{
"id": "ucp_prod_k7x",
"quantity": 1
}],
"buyer": {
"email": "amara@example.com"
}
}
← 200 OK
{
"session_id": "ses_xab9kz...",
"pay_url": "bc.shop/pay/xab9..."
}

Order summary

Kente Smock × 1 175.00
Delivery Free
Total 175.00
amara@example.com
→ Redirecting to payment
POST https://your-app.com/webhook
X-UCP-Signature: sha256=7e9f3c...
{
"event": "checkout.completed",
"order_id": "BC-1042",
"total": 175,
"currency": "USD",
"buyer": {
"email": "amara@example.com"
},
"items": [{
"name": "Kente Smock",
"qty": 1
}]
}
Order confirmed
BC-1042 · Kente Smock · 175.00
amara@example.com · Webhook delivered ✓

Signature verified against your webhook secret. No polling needed — your server is notified the moment payment completes.

Human in the loop

Agents handle the workflow.
Humans close the loop.

Not every transaction completes in a single pass. Sometimes a buyer needs to confirm a custom order, verify an address, or ask a question about a return. UCP supports seamless escalation — when an agent hits a decision point it can't resolve alone, the flow routes to a real person without losing any context.

The conversation doesn't break. The sale doesn't drop. Every transaction finds its path to completion.

Transaction flow

Step 1
Agent discovers & browses
Step 2
Creates checkout session
Decision point
Human needed — escalated
Step 4
Order placed ✓
MCP · Model Context Protocol

Tools your AI agent can use natively.

MCP is the protocol that lets AI models like Claude call external tools. The Bareconnect MCP server exposes commerce as agent-callable actions — no prompt engineering, no brittle parsing.

An agent can receive "find me a cotton dress under $30 and place an order" and the MCP server handles discovery, browsing, and checkout end-to-end.

MCP Tool Calls
discover_stores()
Search all stores by keyword or category
get_store_catalog()
Browse products with price and availability
create_checkout()
Start a checkout session for a buyer
get_checkout_status()
Check if a session was completed

Platform keys

Choose your access level.

Per-store APIs are open to everyone. A platform key unlocks the full store directory, usage analytics, and webhook access across the network.

No key required

Open access

Any developer can browse catalogs, create checkouts, and read per-store discovery — without registering anything.

  • Store discovery endpoint
  • Product catalog + search
  • Checkout & payment flow
  • LLM store summaries
Partner Developer

Developer key

For developers and small platforms building UCP integrations, shopping tools, or catalog syncs.

  • Everything in open access
  • Full paginated store directory
  • Attribution tracking & analytics
  • Webhook registration
AI Platform

Platform key

For AI platforms and shopping agents with production traffic. Priority support, extended rate limits.

  • Everything in developer key
  • Higher rate limits
  • Priority attribution in analytics
  • Direct partner support

Commerce that speaks machine.

Request a platform key and start building the next generation of shopping experiences.