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).