poppy.json examples you can copy
Five real world shapes of poppy.json, from a plumber with no API to a software company with an MCP server. Each one passes the Personal Agent Protocol 1.0 checks. Replace the name and domain with yours, or generate yours in a minute.
A plumber whose customers book by phone or web form
Any local business without an API or online booking.
{
"protocol_version": "1.0",
"organization": {
"name": "Example Plumbing",
"domain": "exampleplumbing.com"
},
"auth": {
"disabled": true
},
"web": {}
}
- web: {} tells agents they may use the website.
- auth.disabled says there is no customer sign in.
A mover that lets Quotebee answer agents
A trades business that wants agents to get its prices and send quote requests, without building anything.
{
"protocol_version": "1.0",
"organization": {
"name": "Example Movers",
"domain": "examplemovers.com"
},
"auth": {
"disabled": true
},
"apis": [
{
"type": "mcp",
"url": "https://getquotebee.com/b/example-movers-k3m9/mcp",
"description": "Services, service area, prices and quote requests for Example Movers, answered by Quotebee for the business."
}
],
"web": {}
}
- The MCP endpoint is the mover's own listing on Quotebee: services, area, price ranges and quote requests.
- The file still lives on the mover's own domain, which is what proves the business is theirs.
A restaurant with its own booking agent
A business that already runs a customer facing agent.
{
"protocol_version": "1.0",
"organization": {
"name": "Example Bistro",
"domain": "examplebistro.com"
},
"auth": {
"disabled": true
},
"agent": {
"protocols": [
{
"type": "poppy",
"endpoint": "https://examplebistro.com/poppy/conversations",
"description": "Book or change a table, and questions about the menu and allergens"
}
]
},
"web": {}
}
- agent.protocols with type "poppy" points personal agents at the restaurant's own agent for a conversation.
- Without sign in, the conversation runs as a signed out session.
An online store with customer accounts
A business whose customers sign in to see orders.
{
"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": {}
}
- auth.scopes lists what an agent can ask the customer to allow, in words the customer reads.
- scope_hints say whether each scope changes anything ("none", "reversible" or "irreversible") and touches personal data.
A software company with an MCP server
A SaaS product that already exposes tools over MCP.
{
"protocol_version": "1.0",
"organization": {
"name": "Example Projects",
"domain": "exampleprojects.com"
},
"auth": {
"scopes": {
"projects:read": "See your projects and tasks",
"projects:write": "Create and update tasks"
},
"scope_hints": {
"projects:read": {
"changes": "none",
"personal_data": false
},
"projects:write": {
"changes": "reversible",
"personal_data": false
}
}
},
"apis": [
{
"type": "mcp",
"url": "https://mcp.exampleprojects.com/mcp",
"description": "Projects, tasks and comments"
}
],
"tasks": {
"endpoint": "https://api.exampleprojects.com/poppy/tasks"
}
}
- apis lists the MCP server; agents read its tools from there.
- tasks gives agents somewhere to ask for things you do not offer yet.
Before you publish
- organization.domain must be exactly the host that serves the file, with no https:// and no path.
- Every URL in the file must be https.
- Serve it at /.well-known/poppy.json on that same host.
- Check the live file with the validator.
New to Poppy? Start with what is poppy.json. Updated Nov 17, 2026.
Run a trades business?
Get quoted when customers ask ChatGPT for your trade. Free to set up.
Get listed free