Guides for UCP spec version 2026-04-08. Platform availability and setup steps may change as the ecosystem evolves.

Platform Guides

UCP implementation varies by platform. Shopify has native support. Other platforms use the UCP Proxy or custom adapters. Here is how to set up UCP on each major platform.

Shopify Native Support

Shopify merchants get UCP out of the box. No code required. Shopify's Agentic Storefronts feature manages your presence across AI platforms.

1

Enable Agentic Storefronts

In your Shopify Admin, go to Settings > Agentic Storefronts. Enable the surfaces you want to sell on:

  • Google AI Mode in Search
  • Gemini app
  • ChatGPT
  • Microsoft Copilot
2

Verify your UCP profile

Shopify automatically generates your /.well-known/ucp profile. Verify it:

curl -s https://your-store.myshopify.com/.well-known/ucp | jq .ucp.version
3

Use the UCP CLI for testing

Install Shopify's UCP CLI to test your store's UCP integration:

# Install the UCP CLI
npm install -g @shopify/ucp-cli

# Search your catalog
ucp catalog search "wireless headphones" --business https://your-store.com

# Test a checkout flow
ucp checkout create --business https://your-store.com \
  --item item_123 --quantity 1
That's it

Shopify handles the protocol implementation, payment handlers, and order management. You just enable the surfaces and your products are discoverable by AI agents.

WooCommerce Via UCP Proxy

WooCommerce does not have native UCP support. Use Shopify's open-source UCP Proxy as a translation layer.

1

Deploy the UCP Proxy

git clone https://github.com/Shopify/ucp-proxy.git
cd ucp-proxy
cp .env.example .env
2

Configure the WooCommerce adapter

Edit .env with your WooCommerce store details:

PLATFORM=woocommerce
WOOCOMMERCE_URL=https://your-store.com
WOOCOMMERCE_KEY=ck_your_consumer_key
WOOCOMMERCE_SECRET=cs_your_consumer_secret
PAYMENT_HANDLER=stripe
STRIPE_SECRET_KEY=sk_live_xxx
3

Start the proxy

npm install
npm start
# Proxy running on port 8080
4

Set up the .well-known/ucp redirect

The proxy serves the UCP profile. Point your domain's /.well-known/ucp to the proxy:

# nginx
location = /.well-known/ucp {
    proxy_pass http://127.0.0.1:8080/.well-known/ucp;
    proxy_set_header Host $host;
}

location /api/ucp/ {
    proxy_pass http://127.0.0.1:8080/;
    proxy_set_header Host $host;
}
Key design decisions

The proxy is stateless (session tokens encoded in checkout IDs, no server-side storage), per-tenant (one instance per merchant, scales to zero when idle), and multi-transport (same logic exposed via REST and MCP).

Magento Via Module

Magento has no built-in UCP support. The community module angeo/module-ucp generates a spec-compliant UCP profile. Currently in beta - handles the discovery layer only.

1

Install the module

composer require angeo/module-ucp
php bin/magento module:enable Angeo_Ucp
php bin/magento setup:upgrade
2

Configure signing keys

The module generates ECDSA P-256 signing keys for your UCP profile:

php bin/magento ucp:keys:generate
# Keys stored in var/ucp/keys/
3

Verify the profile

curl -s https://your-store.com/.well-known/ucp | jq .ucp.version
Beta limitation

Version 0.1.x only handles discovery. Catalog and checkout endpoints are planned for subsequent releases. For full UCP support, consider the UCP Proxy with a Magento adapter.

Wix Via UCP Proxy

Use the UCP Proxy with the Wix adapter. Requires OAuth setup and browser handoff flow configuration.

1

Deploy the proxy with Wix adapter

git clone https://github.com/Shopify/ucp-proxy.git
cd ucp-proxy
cp .env.example .env

Configure for Wix:

PLATFORM=wix
WIX_API_URL=https://www.wixapis.com
WIX_API_KEY=your_wix_api_key
WIX_ACCOUNT_ID=your_account_id
2

Configure browser handoff

Wix requires a browser handoff flow for checkout. The proxy returns a continue_url that redirects to Wix's native checkout page. Make sure your agent handles this escalation correctly.

BigCommerce Via UCP Proxy

Use the UCP Proxy with a custom adapter against the BigCommerce Stores API.

1

Get BigCommerce API credentials

In BigCommerce Admin, go to Advanced Settings > API Accounts. Create an account with:

  • Products: read
  • Carts: modify
  • Orders: modify
  • Store Information: read
2

Configure the proxy

PLATFORM=custom
CUSTOM_ADAPTER_PATH=./adapters/bigcommerce.js
BIGCOMMERCE_STORE_HASH=your_hash
BIGCOMMERCE_ACCESS_TOKEN=your_token
BIGCOMMERCE_CLIENT_ID=your_client_id

Custom Platform Build Your Own

If you run a custom platform, implement UCP directly using the OpenAPI schemas as your contract.

1

Download the spec and schemas

# Clone the UCP repo
git clone https://github.com/Universal-Commerce-Protocol/ucp.git

# Key files:
# specification/overview.md - The spec
# schemas/shopping/checkout.json - Checkout schema
# services/shopping/rest.openapi.json - REST OpenAPI
2

Implement the endpoints

At minimum, implement these REST endpoints:

  • GET /.well-known/ucp - Discovery profile
  • GET /catalog - Product search
  • GET /products/{id} - Product detail
  • POST /carts - Create cart
  • PUT /carts/{id} - Update cart
  • POST /checkout-sessions - Create checkout
  • PUT /checkout-sessions/{id} - Update checkout
  • POST /checkout-sessions/{id}/complete - Complete checkout
  • GET /orders/{id} - Order status
3

Validate against schemas

Use the official JSON Schemas to validate your request/response payloads:

const Ajv = require("ajv");
const checkoutSchema = require("./schemas/shopping/checkout.json");

const ajv = new Ajv();
const validate = ajv.compile(checkoutSchema);

if (!validate(checkoutResponse)) {
  console.error(validate.errors);
}
Need fast inference for your UCP agent?

If you are building an AI agent that shops via UCP, gateway.fast provides OpenAI-compatible access to the fastest agentic models (DeepSeek, GLM, MiMo UltraSpeed) at cost + 10%. Drop-in replacement for your existing OpenAI client.

Next: Building Agents → ← Previous: Getting Started