Documentation
Guides for running Agent Adapt on a WooCommerce store, free and Pro. 35 guides across 6 sections.
Getting Started
- Getting started with Agent AdaptWhat Agent Adapt does for a WooCommerce store, what it needs to run, how to install it and how to check it is working.
- What agents can do at your storeEverything a personal agent can do at a store running Agent Adapt, signed out and signed in, and what it can never do.
- Site Health checksThe six checks Agent Adapt adds to Tools → Site Health, what each one tests, and how to fix a check that fails.
Guides
- The Personal Agent Protocol, explained for store ownersWhat the Personal Agent Protocol is, who published it and when, what it asks of a store, what it leaves undecided, and what it means for a WooCommerce shop.
- What poppy.json is, and what yours saysThe discovery file every personal agent reads first: where it lives, each field in it, what Agent Adapt publishes for your store, and how to check yours.
- What happens when a customer's agent shops your store, step by stepA full visit from a personal agent, from reading poppy.json to the customer paying on your checkout, with what the customer sees and what you see at each step.
- How your store knows which agent is calling (and why there are no API keys)How a personal agent proves its identity to your store: a published address, public keys, signed requests and key-bound tokens, explained without the acronyms first.
- AI shopping agents and your WooCommerce store: what is happening, and what to doHow AI assistants reach online stores today, the three choices a WooCommerce store owner has, what serving agents properly involves, and what not to expect.
- Is it safe to let AI agents into your store?The risks store owners raise about AI agents, one by one: spending, customer data, staff accounts, stolen tokens, rogue agents, phishing and load, and what is done about each.
- Personal Agent Protocol, UCP, ACP, AP2 and MCP: what each one doesThe five protocols store owners hear about in 2026, who publishes each, what it covers, who holds the checkout, and how they fit together. Checked 12 October 2026.
- Do you need an MCP server for your WooCommerce store?What an MCP server at a store does, how it differs from the Personal Agent Protocol's agent API, which customers it reaches, and when a WooCommerce store should run one.
- Free or Pro: which does your store need?What the free Agent Adapt plugin does on its own, what each Pro feature adds, the questions that tell you whether you need it, and what Pro costs.
- What Agent Adapt works with: WooCommerce setups, checkouts, hosts and other pluginsWhich WooCommerce setups Agent Adapt is tested with, what it needs from hosting, how it behaves with caches, security plugins and multisite, and which integrations don't exist yet.
- Preparing your store for personal agents: a checklistEverything to check before and after installing Agent Adapt: hosting, product data, policy pages, coupons, caching, staff accounts, privacy wording and a first test.
- Finding agent orders in WooCommerce: attribution, reports and webhooksHow to tell which orders came through a personal agent: the order list, the order screen, WooCommerce Analytics, the Agents screen, and Pro's insights and webhooks.
- Writing store policies an agent can readAgents quote your returns, terms and privacy pages to customers. Which pages Agent Adapt sends, how it sends them, and how to write them so the answer comes out right.
- Help text for your customers: connecting an assistant to your storeCopy-ready wording for your own help page or FAQ, explaining to customers how to connect an AI assistant to their account, what it can do, and how to disconnect it.
- Check that your store answers agents: five requests you can run yourselfFive curl commands that show whether a personal agent can reach your store, what a healthy answer looks like for each, and what each kind of wrong answer means.
- An assistant says it can't reach your store: what to check, by symptomA diagnostic path for the message a customer brings you, from 'it can't find your store' to 'it was connected and now it isn't', with the cause behind each and the fix.
- An agent's first visit, request by request (for developers)The six HTTP requests a personal agent makes to shop at a store running Agent Adapt, with every field: discovery, the signed token request, DPoP, search, cart, checkout link.
- Glossary: the words in the protocol and in Agent AdaptPlain definitions of the terms used by the Personal Agent Protocol and by Agent Adapt: Session, Account Token, DPoP, scope, operation, checkout link, allowlist and more.
Your customers
- Connected agents and the connection emailThe Connected agents tab in My Account, how customers disconnect an assistant, the email they get, and when access ends on its own.
- How agent orders reach your checkoutHow an agent hands its cart to the customer, how long the checkout link lasts, and how agent orders show in WooCommerce's order attribution.
- How customers connect their assistantWhat your customers see when their AI assistant asks to use their account: the sign-in page, the device code page, and what they approve.
Store control
- Which accounts can connect to an agentOnly customer accounts can be connected to a personal agent. Staff and administrator accounts are refused, at sign-in and on every request.
- See and block agentsThe WooCommerce → Agents screen: which agents have used your store, their sessions and orders, and how blocking and unblocking work.
- What Agent Adapt stores and sharesWhat Agent Adapt keeps in your database, how long it keeps it, what it fetches from agents, and what it never sends anywhere.
Pro
- Agent insightsProPro's Agent insights screen: sessions, orders and net revenue through agents, the funnel by agent, abandoned carts, and where agents get stuck.
- Agent webhooksProSend agent events to another system with WooCommerce webhooks: orders through agents, checkout links, sign-ins, sessions and operations.
- The MCP serverProPro's MCP server lets any MCP-capable assistant use your store with the customer's sign-in. Its address, its tools, and what customers do to connect.
- Approvals for changes (operations)ProHow Pro lets an agent cancel a paid order with a refund, send a return request or change an address, with the customer approving exact terms.
- Merchant policyProPro's policy settings: switch agent actions off, set your return window, cap an agent at view-only, and accept only agents you choose.
Troubleshooting
- Frequently asked questionsShort answers to the questions store owners ask most about Agent Adapt: payments, customer data, blocking agents, staff accounts and caching.
- Caches, CDNs and security pluginsWhich paths to exclude from page caches, CDNs and firewalls so personal agents can reach your store, and how to tell when something is in the way.
- Limits, lifetimes and developer filtersRate limits, how long tokens, codes and links last, and the filters developers can use to change Agent Adapt's behaviour.
No guides match that search. Try another term, or ask us.