@xpaysh/ucp-schemas
v0.2.0
Published
Universal Commerce Protocol (UCP) schemas + business-profile generator. Emits the JSON body for /.well-known/ucp per Google's UCP profile guide and ucp.dev specification. Ships real JSON Schemas vendored from Universal-Commerce-Protocol/ucp (83 files: dis
Maintainers
Readme
@xpaysh/ucp-schemas
JSON Schemas for the Universal Commerce Protocol (UCP), packaged as a versioned, npm-installable dependency for the agentic-commerce-for-* plugin family and any third-party consumer.
Vendor-neutral. Tracks the canonical upstream spec — we do not modify schemas, only mirror them with stable versioning.
Status
- v0.0.x — namespace and package shape. No schema content yet. Use this release to verify your import path; do not rely on
schemashaving entries. - v0.1.0 — first schema content drop. Lifted from the upstream
source/schemas/directory andsource/services/shopping/openapi.json. Pinned viaSPEC_VERSION. - Future revisions tag a new minor version per upstream dated revision.
Install
npm install @xpaysh/ucp-schemasUsage
import { SPEC_VERSION, SPEC_URL, getSchema, schemas } from '@xpaysh/ucp-schemas';
console.log(SPEC_VERSION); // '2026-04-08'
// v0.1.0+:
// const cartSchema = getSchema('cart');
// const result = validate(cartSchema, payload);Versioning policy
The package version tracks the package shape, not the spec. SPEC_VERSION always identifies which upstream revision the bundled schemas come from. New upstream revisions → minor bump (additive). Breaking package-API changes → major bump.
Upstream
- Spec repo: Universal-Commerce-Protocol/ucp
- Current revision tracked:
2026-04-08 - Notable: UCP normatively requires HTTP Message Signatures (RFC 9421) for request integrity. Signature-related schemas (Signature, Signature-Input, Content-Digest payloads) ship in v0.1.0.
- MCP / A2A binding shapes are included in v0.1.0.
License
Apache-2.0. Schema content (when added in v0.1.0) inherits the upstream spec's Apache-2.0 license.
See also
@xpaysh/acp-schemas·@xpaysh/ap2-schemas- Plugin template (this monorepo's root)
- docs.xpay.sh — ACP vs UCP vs AP2 comparison
