# 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](https://getquotebee.com/tools/poppy-json-generator/) 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](https://getquotebee.com/tools/poppy-json-validator/).

New to Poppy? Start with [what is poppy.json](https://getquotebee.com/poppy-json/). 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. https://getquotebee.com/tools/poppy-json-generator/

Source: https://getquotebee.com/poppy-json/examples/
