# 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.

This page is interactive: open it in a browser. Choose "Quotebee answers for me" to get a free agent endpoint for your business and a poppy.json that points to it, verified when the file is live on your domain. Or make the file yourself with your own endpoints, and check any poppy.json against Poppy 1.0. The rules it checks are listed below.

New to Poppy? Read [what is poppy.json](https://getquotebee.com/poppy-json/), copy one of the [examples](https://getquotebee.com/poppy-json/examples/), or check a file with the [validator](https://getquotebee.com/tools/poppy-json-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](https://getquotebee.com/ai-search/).

## 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](mailto:hello@getquotebee.com?subject=poppy.json) 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](https://getquotebee.com/ai-search/).

## 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](https://personalagentprotocol.org/docs/1.0/spec)
- [Sierra: Personal Agent Protocol announcement](https://sierra.ai/blog/poppy)
- [Squarespace forum: files under /.well-known/ are not possible](https://forum.squarespace.com/topic/223965-puting-file-to-domainwell-knownfoo/)
- [Wix Studio forum: hosting root files on Wix with Cloudflare Workers](https://forum.wixstudio.com/t/workaround-how-to-host-root-files-txt-md-json-on-wix-using-cloudflare-workers/75888)

Checked against Poppy 1.0. Updated Nov 17, 2026.

Source: https://getquotebee.com/tools/poppy-json-generator/
