Why do I need a Validator?

This validator helps ensure that your store's `.well-known/ucp` file is correctly formatted and that all required fields are present according to the latest specification.

What makes a UCP profile valid?

A valid UCP profile must be a proper JSON object, include a `version` string, and define at least one of the core commerce components: `capabilities`, `services`, `payment_handlers`, or `endpoints`. Furthermore, all capabilities and services must specify their own `version` and reference a valid `schema` URI.

How do I add UCP to my website?

Simply serve a valid JSON file at the exact path `/.well-known/ucp` at the root of your domain. Ensure your server returns it with the `application/json` content type and allows CORS if you expect external web-based agents to read it.

Engineering tools · UCP

Universal Commerce Protocol (UCP) Validator & Tester

Free UCP validator & readiness checker. Check if your store's .well-known/ucp manifest complies with the Universal Commerce Protocol. including AP2 Agent Payments, Order Capability, Identity Linking, and AI agent readiness.

Universal Commerce Protocol (UCP) Validator & Tester

Domain Name

Frequently Asked Questions

The Universal Commerce Protocol (UCP) is an open standard designed for AI-driven commerce. It facilitates seamless interactions between AI agents, consumer platforms, and business systems.
This validator helps ensure that your store's .well-known/ucp file is correctly formatted and that all required fields are present according to the latest specification.
A valid UCP profile must be a proper JSON object, include a version string, and define at least one of the core commerce components: capabilities, services, payment_handlers, or endpoints. Furthermore, all capabilities and services must specify their own version and reference a valid schema URI.
Simply serve a valid JSON file at the exact path /.well-known/ucp at the root of your domain. Ensure your server returns it with the application/json content type and allows CORS if you expect external web-based agents to read it.

Reading

What is the Universal Commerce Protocol (UCP)?

The Universal Commerce Protocol (UCP) is a groundbreaking standard enabling seamless, agent-to-agent negotiations and automated transactions. By hosting a simple `.well-known/ucp` JSON manifest on your domain, you signal to AI agents and external platforms exactly which commerce capabilities your store supports.

This includes endpoints for product discovery, dynamic pricing negotiation, cart management, secure checkout, and supported payment handlers (such as Google Pay or Apple Pay). By standardizing these interactions, UCP eliminates the need for closed proprietary APIs and allows any agentic system to interact with your business autonomously.

Check Your UCP Readiness Score

A malformed `.well-known/ucp` file means AI agents won't understand how to interact with your store, leading to lost sales in the agentic web. Our free UCP Validator checks your UCP readiness across **40+ tests**. discovery, checkout flow, order capability, identity linking, AP2 agent payments, payment handlers, negotiation protocol, and security. Get a grade (A–F) plus actionable fixes for every failure.

Documentation & Examples

To learn more about implementing the Universal Commerce Protocol on your storefront, visit the official UCP Specification and explore the Schema Authoring Guide. These resources provide comprehensive instructions on structuring your capabilities, services, and payment handlers.

Looking for examples of valid AI commerce manifests? Try testing these domains in our validator above:

Protocol standard

ucp.dev. The official protocol website.

Live checkout

checkout.coffeecircle.com. Example of a complete commerce integration with cart capabilities, Shop Pay, and Google Pay configured.