Quotebee for business

What is poppy.json?

poppy.json is a small JSON file a business publishes at yourdomain.com/.well-known/poppy.json. It tells a person's AI agent who the business is and how to work with it: which MCP server, API or company agent to use, whether the website may be used, and how customers sign in. It is the discovery file of the Personal Agent Protocol, Poppy for short.

Where it liveshttps://yourdomain.com/.well-known/poppy.json
FormatJSON
SpecificationPersonal Agent Protocol 1.0
Published bySierra, with Meta and a group of design partners
Requiredprotocol_version, organization, and at least one of agent, apis or web
CostFree. Make one with the poppy.json generator

How an AI agent uses poppy.json

A complete poppy.json

An online store with customer accounts, an API, and a website agents may use:

{
  "protocol_version": "1.0",
  "organization": {
    "name": "Example Outfitters",
    "domain": "exampleoutfitters.com",
    "logo_uri": "https://exampleoutfitters.com/logo.png"
  },
  "auth": {
    "scopes": {
      "orders:read": "See your orders and returns. Needed to track an order",
      "orders:write": "Return or exchange items. Needed for any change to an order"
    },
    "scope_hints": {
      "orders:read": {
        "changes": "none",
        "personal_data": true
      },
      "orders:write": {
        "changes": "irreversible",
        "personal_data": true
      }
    }
  },
  "apis": [
    {
      "type": "openapi",
      "url": "https://api.exampleoutfitters.com/openapi.json",
      "description": "Orders, returns and exchanges"
    }
  ],
  "web": {}
}

More, from a plumber with no API to a software company with an MCP server: poppy.json examples.

Every field

FieldRequiredWhat it says
protocol_versionYesThe version the file follows: "1.0".
organizationYesYour name, the domain that serves the file, and an optional https logo.
apisOne of apis, agent or webYour MCP server or OpenAPI description: a type ("mcp" or "openapi"), an https URL and a short description.
agentOne of apis, agent or webYour own company agent: the https endpoint where personal agents hold conversations with it.
webOne of apis, agent or webWhether agents may browse your site, and where a browser joins a session. {} means browsing is fine.
authNoSign in through OAuth, the scopes agents can ask for, and hints on whether each scope changes anything or touches personal data. Set disabled to true if you offer no sign in.
tasksNoAn https endpoint for tasks you do not support yet, and for feedback.
supported_versionsNoOther protocol versions you serve, each with the URL of its document.
extensionsNoThe extensions you support, keyed by name.

Who is behind it

Sierra published the Personal Agent Protocol with Meta and a group of design partners, including OpenAI, Shopify and Stripe. Version 1.0 came out on November 13, 2026. Meta's Muse agent now looks for a poppy.json first on every site it visits, and Shopify and Wix publish one automatically for their sites. Most other websites, including almost every WordPress site, do not have one yet.

poppy.json, MCP, llms.txt and robots.txt

FileWhat it is for
poppy.jsonHow a customer's own agent can work with your business: which channels, and how customers sign in
An MCP serverThe tools an agent can call, such as getting a price or booking. poppy.json can point to it
llms.txtA plain text guide to your site's content for language models
robots.txtWhich crawlers may visit which pages
LocalBusiness structured dataYour business facts, such as address, hours and services, in a form search engines read

How to add poppy.json to your website

WordPress sites can upload it with the host's file manager. Wix, Squarespace and Webflow do not allow files in /.well-known/, and need Cloudflare in front of the site. Setup by platform.

For trades businesses

A plumber, roofer or mover does not need to build an agent to use Poppy. With Quotebee, your poppy.json points agents to a listing we run for you, with your services, area and prices, and quote requests come straight to you. Get listed free.

Questions

Is poppy.json required?

No. It is optional, like robots.txt. Without it, agents fall back to reading and using your website like a person would.

Does poppy.json help my Google ranking?

No. Search engines do not use it for ranking. It is for agents acting for a customer.

Do I need an API or MCP server to publish one?

No. The smallest valid file names your business and allows agents to use your website. You can add APIs or an agent later.

Which agents read poppy.json today?

Support is just starting. The protocol's design partners include OpenAI, which is a reason to expect it in ChatGPT, but no agent has announced full support yet.

Can the endpoints live on another domain?

Yes. The file must be on your own domain, but the MCP server, API or agent it points to can be hosted anywhere, which is how a service like Quotebee can answer for a business.

What is the difference between poppy.json and agents.json?

agents.json is a separate, earlier proposal for describing APIs to agents. poppy.json is the discovery file of the Personal Agent Protocol and also covers sign in, company agents and website use.

Sources

Updated Nov 17, 2026.

Run a trades business? Get quoted in ChatGPT.

Add your prices and service area. When customers ask ChatGPT or Claude for your trade, they get your price and you get the request. Free to set up, about ten minutes.

Get listed free