> ## Documentation Index
> Fetch the complete documentation index at: https://betterdatainc.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Commerce Registry Protocol

> Open protocol for gateway resolution, registration, and discovery (MIT).

# Commerce Registry Protocol

The **Commerce Registry Protocol** is an open specification (MIT) for resolving brands and GTINs to gateway endpoints, registering gateways, and discovering them via `.well-known` endpoints.

## Specification (canonical in repo)

The protocol spec lives in this repo under **docs/oss/protocols/commerce-registry/**:

* **README.md** — Overview and index
* **spec/resolution.md** — Brand and GTIN resolution
* **spec/registration.md** — Gateway registration and verification
* **spec/well-known.md** — `.well-known/commerce-gateway.json` schema

## Related

* **registry-mcp** (`@commercegateway/registry-mcp`) implements client behavior for this protocol.
* **OSS ↔ Cloud demo** connectivity uses the same resolution behavior; see the OSS release contracts index: **docs/oss/release-contracts/INDEX.md** (system: oss-cloud-demo-connectivity).