{
  "id": "poppy.discovery.poppy-json",
  "protocol": "poppy",
  "layer": "discovery",
  "role": "merchant",
  "status": "required",
  "title": "Publish /.well-known/poppy.json",
  "description": "Draft 0.1 describes a poppy.json discovery file with protocol_version, organization, auth and surfaces.",
  "goal": "Personal agents find your sign-in server and APIs or company agent from this file.",
  "note": "Draft 0.1 published 9 Oct 2026 (frozen at /docs/0.1/spec); draft 0.2 in progress with breaking changes.",
  "how_to_implement": {
    "steps": [
      "Serve /.well-known/poppy.json over HTTPS.",
      "Include protocol_version 0.1, organization, auth issuer and the surfaces you offer."
    ]
  },
  "resources": [
    {
      "label": "Personal Agent Protocol spec (version 0.1)",
      "url": "https://personalagentprotocol.org/docs/0.1/spec",
      "type": "spec",
      "publisher": "Personal Agent Protocol"
    },
    {
      "label": "Personal Agent Protocol changelog",
      "url": "https://personalagentprotocol.org/docs/changelog",
      "type": "spec",
      "publisher": "Personal Agent Protocol"
    },
    {
      "label": "Sierra: introducing Personal Agent Protocol",
      "url": "https://sierra.ai/blog/introducing-personal-agent-protocol",
      "type": "announcement",
      "publisher": "Sierra"
    }
  ],
  "audit": {
    "method": "http_get",
    "automatable": true,
    "url_pattern": "/.well-known/poppy.json",
    "expect": {
      "status": 200,
      "content_type": "application/json",
      "json_keys": [
        "protocol_version",
        "organization",
        "auth"
      ]
    },
    "human": "GET returns 200 JSON with protocol_version, organization and auth."
  },
  "how_to_verify": "GET returns 200 JSON with protocol_version, organization and auth.",
  "artifacts": [
    "/.well-known/poppy.json"
  ],
  "depends_on": [],
  "status_note": "Draft 0.1 published 9 Oct 2026 (frozen at /docs/0.1/spec); draft 0.2 in progress with breaking changes.",
  "verified": true,
  "slug": "poppy-discovery-poppy-json",
  "category": "discovery",
  "url": "https://vreeman.ai/commerce/checklist#poppy.discovery.poppy-json",
  "updated": "2026-10-19",
  "sources": [
    {
      "label": "Personal Agent Protocol spec (version 0.1)",
      "url": "https://personalagentprotocol.org/docs/0.1/spec",
      "type": "spec",
      "publisher": "Personal Agent Protocol"
    },
    {
      "label": "Personal Agent Protocol changelog",
      "url": "https://personalagentprotocol.org/docs/changelog",
      "type": "spec",
      "publisher": "Personal Agent Protocol"
    },
    {
      "label": "Sierra: introducing Personal Agent Protocol",
      "url": "https://sierra.ai/blog/introducing-personal-agent-protocol",
      "type": "announcement",
      "publisher": "Sierra"
    }
  ],
  "related_slugs": []
}