---
title: "What Is a Poppy File, and What Should a Company Publish?"
slug: "poppy-file-personal-agent-protocol-what-companies-publish"
author: "Miguel Amigot"
date: "2026-11-19 12:00:00"
category: "Premium"
sector: "enterprise"
topics: "Personal Agent Protocol, Poppy, poppy.json, AI agent discovery, agentic commerce, Shopify AI agents, MCP, OpenAPI, UCP, enterprise AI agents, agent readiness"
summary: "Sierra and Meta released Personal Agent Protocol 1.0 on November 13, 2026, and Sierra says every Shopify store now publishes a Poppy file. The file is a short list of pointers to a company's sign-in, APIs and agent, so what matters is who runs the systems it points to."
banner: ""
thumbnail: ""
linkedin: |
  On November 13, 2026, Sierra and Meta released Personal Agent Protocol 1.0, nicknamed Poppy. Sierra says Shopify has enabled it for every merchant, so every Shopify store now publishes a Poppy file with no extra work.

  A Poppy file is one JSON document at /.well-known/poppy.json. It tells a customer's personal agent how to sign in, which scopes exist, which of them make irreversible changes, and where the company's APIs and its own agent live.

  Meta's Muse agent now looks for that file first on every site it visits, according to Sierra. More than 100 companies are design partners.

  The file itself is small. The hard part is everything it points to: the sign-in issuer, the MCP and OpenAPI endpoints, the company agent that answers. Whoever runs those decides what a customer's agent can do.

  With ibl.ai you own all the code and the data behind those endpoints, on any model, with no per-seat pricing.

  #iblai #AgenticAI #EnterpriseAI #PersonalAgents #AgenticCommerce #MCP
faqs:
  - question: "What is a Poppy file?"
    answer: "It is the discovery file defined by Personal Agent Protocol (Poppy), published at /.well-known/poppy.json on a company's domain. It tells a personal agent how to sign in, which scopes exist, where the company's MCP or OpenAPI APIs and company agent live, and which extensions the company supports."
  - question: "Does every Shopify store publish a Poppy file?"
    answer: "Sierra's November 13, 2026 announcement says Shopify has enabled Poppy for every merchant and that every Shopify store now publishes a Poppy file automatically. That is Sierra's statement about its partner; check a specific store's /.well-known/poppy.json to confirm."
  - question: "Is a Poppy file the same as llms.txt or agents.md?"
    answer: "No. llms.txt and Shopify's agents.md describe a site in prose for a model to read. A Poppy file is structured JSON that declares how an agent signs in on a customer's behalf and which endpoints and permissions it can use."
---

## The Short Answer

**A Poppy file is the JSON document a company publishes at /.well-known/poppy.json so a customer's personal AI agent knows how to sign in, what it may do and which APIs or company agent to call. The file is easy; the systems it points to are the work. On ibl.ai you own all the code and the data behind those endpoints, on any model.**

The name comes from Personal Agent Protocol (Poppy), which Sierra and Meta are developing with more than 100 design partners. Version 1.0 shipped on November 13, 2026.

## What did Sierra and Meta release on November 13, 2026?

On November 13, 2026, Bret Taylor and Clay Bavor [announced Personal Agent Protocol 1.0](https://sierra.ai/blog/releasing-poppy) on Sierra's blog. The protocol, nicknamed Poppy, defines how a personal agent acting for one customer connects with a company.

Sierra says version 1.0 reflects about five weeks of design partner testing against real websites, APIs and agents. It adds 60 design partners, bringing the total to more than 100.

The draft came first. On October 9, 2026, [Sierra published the draft](https://sierra.ai/blog/poppy) with initial partners Meta, Genesys, Instinct, NiCE, Rocket, Shopify, Stripe and Walmart, plus 35 more design partners.

## Does every Shopify store really publish a Poppy file now?

According to Sierra, yes. Its 1.0 announcement says "Shopify has enabled Poppy for every merchant on its platform" and that every Shopify store "now automatically publishes a Poppy file". The same post puts Shopify in more than 175 countries.

That is Sierra's account of a partner's rollout, not a Shopify filing. The way to confirm it for one store is to request that store's /.well-known/poppy.json.

When we checked one Shopify store, Allbirds, on November 18, 2026, its file declared protocol_version 0.4, not 1.0, and listed a ucp extension. Publishing a file and publishing the 1.0 version are not the same thing.

Shopify also co-authored Poppy's commerce extension. Sierra describes the split this way: Shopify's Universal Commerce Protocol (UCP) handles finding products, carts and checkout, and Poppy handles the step before, which is who the agent is and what it is allowed to do.

On the agent side, Sierra says Poppy is on for everyone who uses Muse, Meta's AI agent, which "automatically looks for Poppy first on every site it visits".

## What does a Poppy file actually contain?

The [Poppy 1.0 specification](https://personalagentprotocol.org/docs/1.0/spec) puts the file at https://{domain}/.well-known/poppy.json, served over HTTPS. It is a short list of declarations, and nearly every one is a pointer to a system the company has to run.

<table style="width:100%; border-collapse:collapse; margin:1.5rem 0; font-size:0.95rem;">
  <thead>
    <tr style="background:#f5f5f0; border-bottom:2px solid #2175C5;">
      <th style="text-align:left; padding:0.75rem; color:#5f6368;">Poppy file section</th>
      <th style="text-align:left; padding:0.75rem; color:#5f6368;">What it declares</th>
      <th style="text-align:left; padding:0.75rem; color:#5f6368;">The decision behind it</th>
    </tr>
  </thead>
  <tbody>
    <tr style="border-bottom:1px solid #e5e7eb;">
      <td style="padding:0.75rem;"><strong>auth</strong></td>
      <td style="padding:0.75rem;">Sign-in issuer, scopes, and hints on which scopes make irreversible changes or touch personal data</td>
      <td style="padding:0.75rem;">Which identity system vouches for the customer, and what an agent may never do without asking</td>
    </tr>
    <tr style="border-bottom:1px solid #e5e7eb;">
      <td style="padding:0.75rem;"><strong>agent</strong></td>
      <td style="padding:0.75rem;">The company agent's protocols and HTTPS endpoints, with an optional access hint</td>
      <td style="padding:0.75rem;">Whether a customer's agent talks to your agent, and whose agent that is</td>
    </tr>
    <tr style="border-bottom:1px solid #e5e7eb;">
      <td style="padding:0.75rem;"><strong>apis</strong></td>
      <td style="padding:0.75rem;">A list of APIs, each typed openapi or mcp, with a URL and description</td>
      <td style="padding:0.75rem;">Which of your systems are exposed to agents at all</td>
    </tr>
    <tr style="border-bottom:1px solid #e5e7eb;">
      <td style="padding:0.75rem;"><strong>web</strong></td>
      <td style="padding:0.75rem;">A browser-session endpoint, or a flag asking personal agents not to browse</td>
      <td style="padding:0.75rem;">Whether agents use the website like a person or go through APIs</td>
    </tr>
    <tr style="border-bottom:1px solid #e5e7eb;">
      <td style="padding:0.75rem;"><strong>tasks</strong></td>
      <td style="padding:0.75rem;">An endpoint for excluded tasks, skills and feedback</td>
      <td style="padding:0.75rem;">What you refuse to let agents do, stated up front</td>
    </tr>
    <tr style="background:#f0f9ff; border-bottom:1px solid #e5e7eb;">
      <td style="padding:0.75rem;"><strong>extensions</strong></td>
      <td style="padding:0.75rem;">Supported extensions by name and major version, such as the ucp extension Shopify stores list</td>
      <td style="padding:0.75rem;">Which industry rules you follow without changing the core protocol</td>
    </tr>
  </tbody>
</table>

Sierra's announcement says the protocol is built largely on existing standards, MCP, OpenAPI and UCP, with OAuth for sign-in, and that companies can adopt it in stages.

## How is a Poppy file different from llms.txt or agents.md?

llms.txt and agents.md describe a site in prose so a model can read it. Shopify's own [agents.md template documentation](https://shopify.dev/docs/storefronts/themes/architecture/templates/agents-md-liquid) says a store serves agents.md at /agents.md, and that /llms.txt and /llms-full.txt mirror its content by default.

A Poppy file does a different job. It is not a description for reading; it is a contract for acting. It tells an agent how a customer signs in, which permissions exist, and which endpoints to call on that customer's behalf.

A company that wants to be both found and used by agents publishes both kinds. ibl.ai's own site serves an llms.txt for the first job; the second job depends on the systems behind the endpoints.

## Why does it matter who runs the systems a Poppy file points to?

Because the file is mostly addresses. The sign-in issuer, the scopes, the MCP and OpenAPI endpoints and the company agent named in it are where a customer's agent is actually admitted or refused, and where every action is recorded.

If those endpoints belong to a vendor's managed service, the vendor's system answers the customer's agent. If they are yours, your rules and your logs do. The same question sits under [Know Your Agent in banking](/blog/know-your-customer-meet-know-your-agent): a company has to answer for agents from its own records.

This is where ibl.ai fits. [Agentic OS](/product/agentic-os) connects a company's data to its agents over MCP, and you own all the code and the data, run it model-agnostic, and deploy it in your cloud, on-premise or air-gapped.

Pricing matters at this layer too. Personal-agent traffic is not tied to employee headcount, so a per-seat license is the wrong shape for it. ibl.ai is priced by usage or a flat license, with no per-seat pricing.

## What should a company do about Personal Agent Protocol now?

Start with the decisions in the table, not the JSON. Sierra says companies can adopt Poppy in stages, and the 1.0 announcement links an implementation kit with a validator.

A practical order: pick the identity system that will issue sign-in for agents; mark which actions are irreversible; choose which systems to expose as MCP or OpenAPI; decide whether a company agent should answer at all.

Then check what you already publish. A Shopify merchant, by Sierra's account, already has a file; a company on its own stack has to write and serve one. Either way, the file can only promise what the systems behind it enforce.

## Why does owning the AI stack matter?

**ibl.ai is the agentic AI platform where you own all the code and the data. You self-host the entire stack inside your own perimeter, run it model-agnostic across any LLM and switch anytime, and pay by usage with no per-seat pricing — so you can deploy anywhere: your cloud, on-premise, GovCloud, or fully air-gapped.**

- **You own all the code and the data.** Full source code under a perpetual license, running on your infrastructure. Not API access to someone else's platform — the stack itself is yours.
- **Model-agnostic.** Run any LLM — Claude, GPT, Gemini, Llama, Command, or your own fine-tune — and switch providers without rewriting the platform.
- **No per-seat pricing.** Usage-based billing against a budget cap you set. Cost tracks what your organization actually uses, not how many people you employ.
- **Deploy anywhere.** Your cloud, your VPC, on-premise, GovCloud, or a fully air-gapped network with no outbound connectivity.

1.6M+ users across 400+ organizations run the platform this way, including NVIDIA, MIT, and Syracuse University.

ibl.ai is family-owned and operated from New York, NY — a U.S.-headquartered, domestically-owned long-term partner, not a vendor that sells licenses and moves on.

[Explore sovereigncorporation.ai](https://sovereigncorporation.ai/)
