For Developers

Developer Portal

Integrate with UCP-Connect using our standardized JSON schema and REST API.

UCP Manifest Schema

The Universal Commerce Protocol uses a JSON manifest at /.well-known/ucp.json to describe your store to AI agents.

ucp.json

{
  "ucp_version": "1.0",
  "store": {
    "name": "My WooCommerce Store",
    "url": "https://mystore.com",
    "currency": "GBP",
    "locale": "en_GB"
  },
  "capabilities": {
    "search": true,
    "cart": true,
    "checkout": "redirect",
    "shadow_cart": true
  },
  "endpoints": {
    "products": "/wp-json/ucp/v1/products",
    "search": "/wp-json/ucp/v1/search",
    "cart": "/wp-json/ucp/v1/cart"
  },
  "rate_limits": {
    "requests_per_minute": 60,
    "burst": 10
  }
}

Schema Reference

ucp_versionstringrequired

The UCP specification version. Currently "1.0".

storeobjectrequired

Store metadata including name, URL, currency, and locale.

capabilitiesobjectrequired

Declares what operations AI agents can perform (search, cart, checkout).

endpointsobjectoptional

Custom API endpoint paths. Defaults to standard WooCommerce REST paths.

rate_limitsobjectoptional

Rate limiting configuration for AI agent requests.

Resources

Setup Guide

Step-by-step .well-known/ucp manifest setup

GitHub Repository

Coming soon: Open source examples

Need API Access?

Join the waitlist to get early access to our developer API and SDKs.

Join Developer Waitlist