05 · Transact · Open source

UCP Catalog Service for Magento 2

angeo/module-ucp-catalog

Implements the catalog.search and catalog.lookup services for Magento 2 — the REST endpoints your UCP profile advertises. Without this, the profile promises capabilities nothing answers.

UCPspec 2026-04-08RESTMIT
# install alongside the profile generator $ composer require angeo/module-ucp angeo/module-ucp-catalog $ bin/magento setup:upgrade # the profile should now advertise services that answer $ curl -s https://your-store.com/.well-known/ucp | jq .capabilities

Free and MIT-licensed. No licence key, no account, no telemetry.

What it does

Four things worth knowing before you install.

Makes the profile honest

angeo/module-ucp declares capabilities at /.well-known/ucp. This module serves them. Declaring a capability you do not implement is worse than declaring nothing — an agent that tries and fails learns not to try again.

catalog.search and catalog.lookup

The two services an agent needs to find a product and then resolve its details, implemented against Magento’s own catalogue rather than a mirror that drifts.

Spec 2026-04-08

Matched to the same protocol version the profile generator declares, so the manifest and the endpoints agree.

Works with Adobe Commerce

Magento Open Source and Adobe Commerce, same code path.

Install this whenever you install the UCP profile. A profile that advertises catalog services with nothing behind them is a worse signal than no profile at all.

Requirements

Pairs withangeo/module-ucp
MagentoOpen Source / Adobe Commerce 2.4.x
PHP8.2+
SpecUCP 2026-04-08
LicenceMIT

Questions

Do I need this if I already have angeo/module-ucp?

Yes, if the profile advertises catalog capabilities. The profile generator declares what you support; this module is what actually answers.

What is the difference from the ACP feed?

The ACP feed is a file you submit to OpenAI. UCP catalog services are live endpoints an agent queries directly. Push versus pull, different consumers.

Does it expose anything not already public?

No. It serves catalogue data that is already visible on your storefront, in the structured form the protocol defines.

Which UCP version does it target?

Spec 2026-04-08, matching the version angeo/module-ucp declares in the profile.

Works with

Each module is independent, but these three are the ones most often installed alongside it.

Not sure whether you need this one?

Run the free scanner on your domain, or install the CLI audit. Both report which signals your store currently fails, so you install only what closes a real gap.