Wilby DocsGet Sandbox Keys

Playbook › AI Agent Makers

AI Agent Makers

You build an AI agent or agent that orders and pays for people.

How your agent orders from Wilby businesses within limits the customer signed, and what happens when it reaches them.

1. What Wilby Does for You

Every Wilby business answers the same way: find what it sells, get a signed price, order inside the customer's limits, hand anything above them back to the customer. Your agent never holds a card and never decides on its own above the limits, and every order has signed proof of what it was allowed to do.

2. What You Set Up, in Order

  1. Connect over MCP: each business's storefront is https://app.usewilby.com/s/<slug>/mcp (connect first) or /mcp/open (browse first, connect to order). Standard OAuth 2.1 with PKCE and dynamic registration. Register once and reuse your registration: sign-ups are limited per address.
  2. Or the plain API: a customer gives your agent an 8-character code; trade it for an agent key: AI Agents.
  3. Identify yourself: sign your requests (published keys) so businesses that only take verified agents accept you.
  4. Or Google's Universal Commerce Protocol (UCP): every Wilby business with UCP on publishes a profile at https://app.usewilby.com/ucp/<slug>/.well-known/ucp; open checkout sessions there (REST or MCP), pay with a Google Pay token, sign your requests with a key from your own profile, link a customer's account with OAuth (the customer's own limits then apply), and send AP2 checkout mandates if you use them: Agent Storefront.
  5. Or bring your own signed permission: AP2, Mastercard Verifiable Intent or the Agentic Commerce Protocol: Outside Agent Permissions.

3. Rules Your Agent Follows

4. What You Get Back

5. Testing

Two sample storefronts are open in the sandbox: an online shop, Harbor Home Goods (https://app.usewilby.com/s/harbor-home-sample/mcp: search products, options, delivery to a saved address), and a flower shop with pickup times, Little Fern Flowers (https://app.usewilby.com/s/little-fern-sample/mcp). Add either as a connector.

6. When Something Goes Wrong

7. Links

Agent Storefront · AI Agents · Outside Agent Permissions


Other paths: Platforms and Marketplaces · Stores on a Platform · Businesses With Their Own Website · Banks and Card Networks · Processors and Payment Companies