# poppy.json validator

Paste a poppy.json to check it against the Personal Agent Protocol 1.0. It runs in your browser: nothing you paste is sent anywhere.

The validator on this page is interactive: open it in a browser. The checks it runs are listed below.

## What it checks

- protocol_version is present, as "major.minor".
- organization has a name, and a domain that matches the host you say serves the file.
- At least one channel is declared: agent, apis or web.
- Every endpoint is https, every api has a type ("mcp" or "openapi"), a url and a description.
- Every agent protocol has a type, an https endpoint and a description; access is "session" or "signed_in".
- Every scope hint covers a declared scope, with changes set to "none", "reversible" or "irreversible" and personal_data true or false.

## Common mistakes

| Error | Fix |
| --- | --- |
| organization.domain does not match the host | Use the bare host that serves the file, for example www.example.com if your site lives on www. |
| Declare at least one channel | Add "web": {} if agents may use your website and you have nothing else. |
| Must be an https URL | Agents only follow https endpoints. Change http:// to https://. |
| Hint for a scope that auth.scopes does not declare | Add the scope to auth.scopes, or remove its hint. |
| Not valid JSON | Look for a trailing comma or a missing quote. Copy a working file from the examples. |

No file yet? [Generate one](https://getquotebee.com/tools/poppy-json-generator/), copy one from the [examples](https://getquotebee.com/poppy-json/examples/), or read [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/tools/poppy-json-validator/
