UCP Validate
Run a lightweight validation pass against a deployed UCP profile.
Run
python ${CLAUDE_SKILL_DIR}/scripts/validate_ucp.py \
https://example.com \
--output store/clients/example/validation-report.md
What This Script Checks
/.well-known/ucpor/.well-known/ucp.jsonexists- JSON parses and has a top-level
ucpobject ucp.versionusesYYYY-MM-DDucp.services,ucp.capabilities, anducp.payment_handlersexist- service entries include required basics such as
versionand endpoint for network transports - payment handler entries include
idandversion - up to five capability
spec/schemaURLs are reachable - offline validation against the vendored official UCP profile schema
(
refs/ucp-schema/2026-04-08/), whenjsonschemais installed - local availability of official
ucp-schemaand conformance tooling
What It Does Not Yet Check
- Catalog search/lookup behavior
- Checkout create/update/retrieve/cancel lifecycle
- Payment handler runtime behavior
- Real conformance-suite execution
Use official UCP tools for those deeper checks.
Output
Writes:
validation-report.mdvalidation.jsonwhen--json-outputis provided
The validator returns PASS, CONDITIONAL PASS, or FAIL based on critical and error-level checks.
Hard Rule
Never call checkout completion or trigger real payment capture during validation.