{
  "id": "poppy.surface.api-or-agent",
  "protocol": "poppy",
  "layer": "foundation",
  "role": "merchant",
  "status": "recommended",
  "title": "Expose APIs or a company agent",
  "description": "The spec lets a business offer APIs (for example MCP), conversations and web browsing in one session.",
  "goal": "Gives personal agents something to do once signed in.",
  "note": "Draft 0.1 published 9 Oct 2026; draft 0.2 in progress with breaking changes.",
  "how_to_implement": {
    "steps": [
      "List your MCP or HTTP APIs, or a company agent, in poppy.json."
    ]
  },
  "resources": [
    {
      "label": "Personal Agent Protocol spec (version 0.1)",
      "url": "https://personalagentprotocol.org/docs/0.1/spec",
      "type": "spec",
      "publisher": "Personal Agent Protocol"
    }
  ],
  "audit": {
    "method": "code_review",
    "automatable": false,
    "human": "Endpoints listed in poppy.json respond."
  },
  "how_to_verify": "Endpoints listed in poppy.json respond.",
  "artifacts": [
    "APIs",
    "company agent"
  ],
  "depends_on": [
    "poppy.discovery.poppy-json"
  ],
  "status_note": "Draft 0.1 published 9 Oct 2026; draft 0.2 in progress with breaking changes.",
  "verified": true,
  "slug": "poppy-surface-api-or-agent",
  "category": "foundation",
  "url": "https://vreeman.ai/commerce/checklist#poppy.surface.api-or-agent",
  "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"
    }
  ],
  "related_slugs": [
    "poppy-discovery-poppy-json"
  ]
}