{
  "id": "ucp.discovery.well-known",
  "protocol": "ucp",
  "layer": "discovery",
  "role": "merchant",
  "status": "required",
  "title": "Publish the UCP business profile at /.well-known/ucp",
  "description": "The business profile tells agents which UCP version, services, capabilities and payment handlers you support.",
  "goal": "Agents start every UCP interaction by fetching this profile. Without it, no UCP platform can find or negotiate with you.",
  "note": "UCP versions are dated (latest release 2026-08-25). The profile is public and cacheable by design.",
  "how_to_implement": {
    "steps": [
      "Create a JSON document with a top-level ucp object: version, services, capabilities and payment_handlers.",
      "Serve it at https://yourdomain/.well-known/ucp over HTTPS.",
      "List only capabilities you actually implement."
    ],
    "snippet": {
      "lang": "json",
      "code": "{\n  \"ucp\": {\n    \"version\": \"2026-08-25\",\n    \"services\": { ... },\n    \"capabilities\": { ... },\n    \"payment_handlers\": { ... }\n  }\n}",
      "source_url": "https://ucp.dev/latest/specification/overview/",
      "source_label": "UCP spec overview, Versioned Profiles example"
    }
  },
  "resources": [
    {
      "label": "UCP spec overview (latest): versioning and hosting",
      "url": "https://ucp.dev/latest/specification/overview/",
      "type": "spec",
      "publisher": "UCP"
    },
    {
      "label": "UCP spec overview (2026-08-25)",
      "url": "https://ucp.dev/2026-08-25/specification/overview/",
      "type": "spec",
      "publisher": "UCP"
    },
    {
      "label": "UCP getting started",
      "url": "https://ucp.dev/specification/getting-started/",
      "type": "docs",
      "publisher": "UCP"
    }
  ],
  "audit": {
    "method": "http_get",
    "automatable": true,
    "url_pattern": "/.well-known/ucp",
    "expect": {
      "status": 200,
      "content_type": "application/json",
      "json_keys": [
        "ucp.version",
        "ucp.services",
        "ucp.capabilities"
      ]
    },
    "human": "GET /.well-known/ucp returns 200 JSON with ucp.version, ucp.services and ucp.capabilities."
  },
  "how_to_verify": "GET /.well-known/ucp returns 200 JSON with ucp.version, ucp.services and ucp.capabilities.",
  "artifacts": [
    "/.well-known/ucp"
  ],
  "depends_on": [],
  "status_note": "UCP versions are dated (latest release 2026-08-25). The profile is public and cacheable by design.",
  "verified": true,
  "slug": "ucp-discovery-well-known",
  "category": "discovery",
  "url": "https://vreeman.ai/commerce/checklist#ucp.discovery.well-known",
  "updated": "2026-10-12",
  "sources": [
    {
      "label": "UCP spec overview (latest): versioning and hosting",
      "url": "https://ucp.dev/latest/specification/overview/",
      "type": "spec",
      "publisher": "UCP"
    },
    {
      "label": "UCP spec overview (2026-08-25)",
      "url": "https://ucp.dev/2026-08-25/specification/overview/",
      "type": "spec",
      "publisher": "UCP"
    },
    {
      "label": "UCP getting started",
      "url": "https://ucp.dev/specification/getting-started/",
      "type": "docs",
      "publisher": "UCP"
    }
  ],
  "related_slugs": []
}