End-user guide

What UCP gives you

The Universal Commerce Protocol is an open standard that lets any

1. What UCP gives you

The Universal Commerce Protocol is an open standard that lets any AI commerce agent transact with your Shopware shop through a single, documented interface — without integration work on your side per agent.

Before UCP, every AI agent that wanted to sell from your shop had to:

Scrape your storefront, or
Use a private API, or
Wait for you to build a custom integration.

With UCP, your shop publishes a single profile at https://your-shop.example.com/.well-known/ucp describing which features you support and how to call them. Any agent that speaks UCP can immediately discover your shop, search the catalog, build a cart, run checkout, and receive a signed order confirmation — through one uniform protocol.

Who is on the other side?

Today this includes (and grows monthly):

ChatGPT (with browsing / commerce integrations)
Perplexity (commerce mode)
Google Gemini with shopping connectors
Anthropic Claude via MCP integrations
Custom enterprise agents built on top of agent frameworks
Marketplace platforms that aggregate inventory

UCP is positioned to do for agentic commerce what RSS did for content syndication: an open contract that lets any platform read from any shop without bilateral deals.

What you control

Activation is per Sales Channel. For each channel you decide:

Lever	What it controls
Active toggle	Whether UCP is on at all for this Sales Channel
Capability toggles	Which protocol features (Cart, Checkout, Discount, …) you expose
Transport selection	REST and/or MCP (more transports later)
Continue URL template	Where agents redirect buyers when escalation is required
Signing keys	The cryptographic keys agents use to verify your webhooks
OAuth scopes	Which user-authenticated operations require login

A peek at your published profile

json

{
  "ucp": {
    "version": "2026-01-23",
    "services": {
      "dev.ucp.shopping": [
        { "transport": "rest", "endpoint": "https://shop.example.com/ucp/v1", … },
        { "transport": "mcp",  "endpoint": "https://shop.example.com/ucp/mcp", … }
      ]
    },
    "capabilities": {
      "dev.ucp.shopping.catalog.search": [ … ],
      "dev.ucp.shopping.cart": [ … ],
      "dev.ucp.shopping.checkout": [ … ],
      "dev.ucp.shopping.discount": [ "extends": [ "cart", "checkout" ] … ],
      …
    },
    "payment_handlers": {
      "com.shopware.invoice": [ … ]
    }
  },
  "signing_keys": [ … ]
}

The full sample profile from a local Dockware shop ships with this documentation at ../images/storefront/well-known-ucp-sample.json.

→ Next: Enabling UCP per Sales Channel