CATALOG · AI SHOPPING AGENTS
Universal Commerce Protocol.
Your catalog, read by agents.
- Who it helps
- Stores opening their catalog to AI shopping platforms that speak UCP.
- What changes
- Approved agents can discover, search and read your catalog at guest prices. Checkout stays yours.
- Discovery, search, batch lookup and product detail
- Guest price parity with the storefront
- Up to 50 identifiers per lookup, correlated answers
Let approved AI shopping agents discover, search and read your catalog at guest prices, answered from your own Magento store. Catalog reads only: checkout stays yours.
8.1–8.5
PHP
2.4 line
Magento Open Source
Compatible
Mage-OS
v 1.0.0 — RELEASED 30 days ago
composer require qoliber/ucp
Product details
Let AI shopping agents read your catalog from your own store.
AI shopping platforms need a standard way to find a store's catalog and read real prices and availability. Without one, your products are not on the table when an assistant shops for a customer, and a custom integration is a project for every platform.
This extension answers the Universal Commerce Protocol (UCP) 2026-08-25 catalog binding from your own Magento store: discovery, search, batch lookup and product detail, with the same guest prices and availability your storefront shows. It covers catalog reads and nothing else. Checkout stays yours.
Who it is for
- Stores onboarding AI shopping platforms that speak UCP version 2026-08-25. The module negotiates exactly that version and refuses older profiles.
- Stores selling in several markets. The catalog is switched on per store view, and every price is quoted in that store view's currency.
- Catalogs built on simple, virtual, downloadable and configurable products with Magento Inventory (MSI) stock.
- Teams that need agent access to be read-only. The profile advertises catalog capabilities only, never carts, checkout, payments or orders.
How it works
- Open a store view. Under Stores → Configuration → Qoliber → UCP Catalog, set Enable UCP Catalog to Yes for the store view. It ships disabled on every scope.
- Onboard a platform. Paste its verified discovery URI and profile snapshot into Cached Platform Profiles. Only listed platforms get data: an unknown profile is refused with HTTP 424, and the module never fetches a URL an agent supplies.
- Agents discover the catalog at
/.well-known/ucp, then search by name or SKU text, filter by category and price, look up as many as 50 SKUs or identifiers per call, and read product detail with each option value'sexistsandavailableflags. - Check what they receive. A product priced 12.34 USD on the storefront reads
{"amount":1234,"currency":"USD"}for an agent, to the minor unit. - Close it again at any time. Set a store view back to No and its discovery and catalog endpoints go offline at once, while the others keep serving.
Nothing needs hosting or scheduling. The module adds no cron job, queue consumer or indexer, and agent traffic starts no PHP session.
Requirements
| PHP | 8.1 to 8.5 with the intl and mbstring extensions |
|---|---|
| Platform | Magento Open Source or Mage-OS on the 2.4 line (magento/framework ^103.0) |
| Stock | Magento Inventory (MSI), with Magento_InventorySales enabled |
| Pricing | Magento_Weee and Magento_Quote enabled, including when fixed product tax is switched off |
| Storefront | An HTTPS base URL on every store view you open to agents |
Limitations
- Catalog reads only. Carts, checkout, payments, identity linking and orders are not part of this extension.
- Grouped and bundle products are outside this release.
- Text search matches product name and SKU with SQL
LIKE. There is no semantic search. - Product detail supports at most 200 variants. A larger configurable is reported and skipped.
- Private catalogs and B2B permission extensions need a dedicated eligibility adapter before the catalog is opened to agents.
- Platform profiles are maintained by hand during onboarding. Automatic onboarding of arbitrary platforms is not supported.
- Add ordinary gateway rate limiting to the public catalog paths in production.
FAQ
Can an agent place an order?
No. The discovery profile advertises catalog capabilities only, and there are no customer, payment or order endpoints.
Will agents see the same price as the storefront?
Agents get the public guest price of the store view. Tax display, catalog price rules, fixed product tax and currency follow the store view. Checkout stays authoritative for address-specific taxes, quantities, shipping and custom-option charges.
Which agents can read the catalog?
Only platforms whose verified profile you added to that store view. Any other profile is refused without a remote fetch.
Does it call an outside service?
No. It answers from your Magento installation and never calls a third-party service.
Does the catalog have to be open on every store view?
No. Each store view has its own switch and its own list of onboarded platforms.
WHAT IT DOES
A standard address for your catalog.
Agents discover each store view at /.well-known/ucp and read the same guest prices and availability your storefront shows, to the minor unit. Only platforms you have onboarded get data, and there is nothing to host or schedule.
- Discovery, search, batch lookup and product detail ● UCP 2026-08-25
- Guest price parity with the storefront ● pricing
- Up to 50 identifiers per lookup, correlated answers ● lookup
- Unknown agent profiles refused with HTTP 424 ● onboarding
- Enabled per store view, offline at once ● control
- No cron, no queue, no sessions ● stateless
INSTALL · COMPOSER
Ships switched off.
The module adds no cron job, queue consumer or indexer. Nothing is public until you enable a store view and add a verified platform profile.
# Once per project: add your private qoliber repository # (the exact command is in your account → Composer & keys) composer require qoliber/ucp php bin/magento setup:upgrade ✓ Enable it per store view: Stores → Configuration → Qoliber → UCP Catalog.
FROM THE COMMUNITY
Customer reviews
Write a review
Write Your Own Review