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.
Check an existing poppy.json
Runs in your browser. Nothing you type or paste is sent to us.
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, copy one from the examples, or read 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