Quickstart

Test a UCP server for conformance

Install the open-source CLI, point it at your store, and get a spec-cited UCP conformance report — from your shell or your CI. UCP is an open standard for agentic commerce, maintained by the UCP project (ucp.dev).

Check your store → See the coverage matrix

Install and run the full suite

Install from PyPI, scaffold a config tailored to what your store declares, then run it against your own store. The full suite reaches the checkout, cart, and order write paths the instant web check does not — so point it at a store you own, never someone else's.

pip install spck-conformance
spck-conformance --server https://store.example.com --init merchant.json
spck-conformance --server https://store.example.com --config merchant.json

On a deviation it shows the requirement next to your actual response. It runs the checks your store declares support for, and reports anything it can't reach as not-tested rather than a silent pass. Runs on Python 3.9+.

Test a shopping agent

The same package tests the buy side. Point a shopping agent at a bundled reference store that behaves correctly and one that misbehaves on purpose — locally, in a single command.

spck-conformance --agent

Each agent check passes a correct agent and catches a broken one. Watch recorded runs in the sandbox →

Gate it in CI

Add the GitHub Action so conformance runs on each push. It fails the build on a MUST deviation and writes a JUnit report.

- uses: vishkaty/ucp-conformance@main
  with:
    server: https://store.example.com
    config: merchant.json   # optional

What gets checked

The full CLI suite covers, across REST and MCP transports:

Each check is anchored to the official ucp-schema validator and cites the spec clause it enforces.

Spec versions

Tests run against the pinned UCP spec versions:

Links