Get your business quoted in ChatGPT, free
Add your prices, service area and license once. When customers ask ChatGPT, Claude or their own AI agent for your trade, Quotebee quotes your price and sends you the request. You also get your poppy.json, the small file that points AI agents visiting your website to your listing. Building your own agent? Make the file yourself instead.
Start with your website
Try your agent
Ask what a customer would ask. This is what ChatGPT, Claude and personal agents get about your business.
Put your agent on your website
Paste this line into your site. Visitors get an Ask about prices button that answers from your details in seconds and sends you their quote requests. It also proves the website is yours, so it can replace the file below.
Your poppy.json
Put this file at . It tells agents that Quotebee answers for .
Check your site and go live
Once the line or the file is on your site, check it. Finding either one on your domain proves the business is yours. Your agent then goes live for ChatGPT, Claude and personal agents, and the Ask box starts answering your visitors.
Can't add code or files to your site? Email hello@getquotebee.com and we will verify you another way.
Save your agent to your account
Sign in with your mobile number and every quote request, every question customers asked your agent, and the prices you gave are in one place, on any phone or computer. We text you a code, no password.
Keep your private link
Use this link to change your details later. Anyone with it can edit your listing, so keep it to yourself.
Make the file yourself
Sign in needs an OAuth authorization server. Add auth.issuer, scopes and scope hints by hand, following the spec.
Check an existing poppy.json
Runs in your browser. Nothing you type or paste is sent to us.
New to Poppy? Read what is poppy.json, copy one of the examples, or check a file with the validator.
Why a trades business should publish one now
- It is the front door for personal agents. The Personal Agent Protocol, from Sierra and Meta with design partners including OpenAI, Shopify, Stripe and Walmart, is how a customer's own agent is meant to find a business, say who it is acting for and get work done.
- Being early costs almost nothing. Agents do not read poppy.json widely yet. The file is a few lines, and your human visitors never see it.
- It says you welcome agents. An agent that finds the file knows it may use your website, and where to send requests.
- You do not need to build an agent. Choose Quotebee on this page and your file points agents to an endpoint we run for your business, with your services, area and prices, that takes quote requests for you. Free.
- It works alongside the rest of AI search. Business profiles, crawler access, published prices and structured data get you into answers today. The full checklist for trades businesses.
Where to put the file
It must be served at exactly https://yourdomain.com/.well-known/poppy.json. A redirect to another domain does not count: agents check that the domain written inside the file matches the site that served it. How easy that is depends on what your website runs on.
| Your site runs on | Can you add the file? | How |
|---|---|---|
| WordPress on your own hosting | Yes | Upload poppy.json into a folder named .well-known at the top of your site, with your host's file manager or FTP. Quotebee is building a free WordPress plugin that does it for you. |
| Wix | Not directly | Wix does not let you add files at the root of your site. The workaround is putting Cloudflare in front of your domain and serving the file from a small Cloudflare Worker. |
| Squarespace | Not directly | Squarespace has no root folder to upload into. The same Cloudflare workaround applies. |
| Webflow | Not directly | Webflow does not support a .well-known folder. The same Cloudflare workaround applies. |
| A custom or static site | Yes | Add the file to the folder your site is deployed from, and check that your host does not skip folders whose names start with a dot. |
Not sure which applies to you? Email us your website address and we will tell you the simplest way for your setup.
What goes in poppy.json
| Field | Required | What it says |
|---|---|---|
| protocol_version | Yes | The version the file follows: "1.0". |
| organization | Yes | Your name, the domain that serves the file, and an optional https logo. |
| apis | One of apis, agent or web | Your MCP server or OpenAPI description: a type ("mcp" or "openapi"), an https URL and a short description. |
| agent | One of apis, agent or web | Your own company agent: the https endpoint where personal agents hold conversations with it. |
| web | One of apis, agent or web | Whether agents may browse your site, and where a browser joins a session. {} means browsing is fine. |
| auth | No | Sign 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. |
| tasks | No | An https endpoint for tasks you do not support yet, and for feedback. |
| supported_versions | No | Other protocol versions you serve, each with the URL of its document. |
| extensions | No | The extensions you support, keyed by name. |
The smallest useful file
A business with no customer accounts and no API needs only its name, its domain, sign in turned off, and one channel. For a plumber whose customers book by phone or a form, the channel is the website:
{
"protocol_version": "1.0",
"organization": {
"name": "Example Plumbing",
"domain": "example.com"
},
"auth": {
"disabled": true
},
"web": {}
}
A business with an MCP server lists it under apis. This is the file Quotebee serves:
{
"protocol_version": "1.0",
"organization": {
"name": "Quotebee",
"domain": "getquotebee.com"
},
"auth": {
"disabled": true
},
"apis": [
{
"type": "mcp",
"url": "https://getquotebee.com/mcp",
"description": "Estimated prices for local moves in any US city, coverage by city, and licensed local movers."
}
],
"web": {}
}
What agents check
- The file is served over https at exactly /.well-known/poppy.json.
- organization.domain matches the host that served the file.
- Every URL in the file is https.
- At least one channel is declared: apis, agent or web.
- Scope hints only cover scopes the file declares, and each says what the scope changes and whether it touches personal data.
How poppy.json fits with the other files
| File | What it is for | Who reads it today |
|---|---|---|
| robots.txt | Which crawlers may visit your site | Every search engine and AI crawler |
| LocalBusiness structured data | Your business facts in a form machines read | Search engines |
| poppy.json | How a customer's agent can work with your business | Early: agents are starting to support it |
| An MCP server | Tools an agent can call, such as getting a price | ChatGPT, Claude and other assistants, once connected |
| llms.txt | A plain text guide to your site for language models | Some AI tools; no public evidence it changes answers |
| WebMCP | Lets a web page offer tools to an agent working in the browser | Chrome, as an early trial |
Examples of structured data and poppy.json for each trade are in the trade guides.
Questions
What does Quotebee answer for my business?
Four things, from what you enter: your business facts (services, area, hours, license), whether you do a job in a zip code, your own price range for a job, and quote requests, sent only with the customer's consent. Agents never see your notification email or mobile. Your endpoint goes live once we find your file on your domain, which is how we know the business is yours.
What does it cost?
Nothing during early access. Later we plan to charge per quote request delivered, never for the file or the listing.
Do AI agents read poppy.json today?
Not yet widely. The protocol was published as a draft in October 2026, and its design partners are still building support. Publishing early means you are ready when they do, at no cost.
What is the Personal Agent Protocol?
An open protocol, published by Sierra with Meta and a group of design partners, for how a person's own AI agent finds a company, says who it is acting for, gets permission and gets work done through the company's website, APIs or agent.
Does poppy.json help my Google ranking?
No. It is not a search ranking signal. It is for agents acting for a customer.
Do I need sign in to publish poppy.json?
No. Without an authorization server you can still offer signed out sessions for your website, APIs and conversations. Set auth.disabled to true.
Is poppy.json the same as MCP?
No. MCP describes the tools an agent can call. poppy.json says which channels you offer, an MCP server among them, and how agents sign in.
I run a local service business. Do I need a developer or my own agent?
No. Choose "Quotebee answers for me" at the top of this page. You fill in your services, area and prices, we run the endpoint agents talk to, and your poppy.json points to it. The only technical step is putting one file on your site.
Sources
- Personal Agent Protocol 1.0 specification
- Sierra: Personal Agent Protocol announcement
- Squarespace forum: files under /.well-known/ are not possible
- Wix Studio forum: hosting root files on Wix with Cloudflare Workers
Checked against Poppy 1.0. Updated Nov 17, 2026.