UCP

Submit Your Merchant

Add your UCP-enabled store to the directory and make it discoverable to AI shopping agents worldwide.

Prerequisites

  • ✓Your store must implement the Universal Commerce Protocol (UCP)
  • ✓You must have a live UCP discovery profile at /.well-known/ucp
  • ✓You must be authorized to represent the merchant

Generate Your Merchant JSON

Fill out the form below to automatically generate your merchant JSON file. No coding required!

Basic Information

Lowercase, hyphens only. Must match filename.

Direct link to your logo image (PNG, JPG, or SVG)

Categories *

Selected: 0

Tags (optional)

Comma-separated, lowercase with hyphens

UCP Capabilities *

Selected: 0

Payment Methods (optional)

Selected: 0

Manual Submission (Alternative)

Prefer to create the JSON manually? Follow these steps:

Submission Steps

1

Fork the Repository

Fork the UCP Merchants repository on GitHub to your account.

git clone https://github.com/awesomeucp/merchants.git
2

Create Your Merchant JSON

Create a new JSON file in the data/merchants/ directory. The filename must match your slug (e.g., your-store.json).

{
  "slug": "your-store",
  "name": "Your Store Name",
  "url": "https://yourstore.com",
  "description": "Brief description of your store and what you sell",
  "logo": {
    "url": "https://yourstore.com/logo.png",
    "width": 400,
    "height": 400,
    "alt": "Your Store Logo"
  },
  "categories": ["electronics", "gadgets"],
  "tags": ["fast-shipping", "warranty", "tech-support"],
  "ucpProfile": {
    "version": "2026-01-11",
    "wellKnownUrl": "https://yourstore.com/.well-known/ucp",
    "capabilities": [
      {
        "name": "dev.ucp.shopping.checkout",
        "version": "2026-01-11",
        "spec": "https://ucp.dev/specification/checkout",
        "schema": "https://ucp.dev/schemas/shopping/checkout.json"
      }
    ],
    "services": {
      "dev.ucp.shopping": {
        "version": "2026-01-11",
        "spec": "https://ucp.dev/specification/shopping",
        "rest": {
          "endpoint": "https://api.yourstore.com/ucp/v1",
          "schema": "https://api.yourstore.com/ucp/v1/openapi.json"
        }
      }
    },
    "paymentHandlers": [
      {
        "name": "dev.ucp.delegate_payment",
        "version": "2026-01-11",
        "providers": ["Google Pay", "Apple Pay"]
      }
    ]
  },
  "metadata": {
    "submittedAt": "2026-01-16T12:00:00Z",
    "submittedBy": "your-github-username",
    "verified": false,
    "featured": false
  }
}
3

Submit Pull Request

Create a branch and submit a pull request with your merchant JSON file.

git checkout -b add-merchant/your-store
git add data/merchants/your-store.json
git commit -m "Add Your Store to merchant directory"
git push origin add-merchant/your-store
4

Wait for Review

Our team will review your submission and verify your UCP implementation. Once approved, your merchant will appear in the directory.

Field Reference

slug*required

URL-safe identifier (lowercase, hyphens only). Must match filename.

name*required

Your store's display name.

url*required

Your store's homepage URL (HTTPS only).

ucpProfile.wellKnownUrl*required

URL to your UCP discovery profile (typically https://yourstore.com/.well-known/ucp).

Need Help?

If you have questions about the submission process or implementing UCP: