# agentPickup

> agentPickup is the commerce and fulfilment infrastructure that lets AI agents buy from physical businesses, for collection in person. Agents find businesses, read their catalogues, ask about them and place orders; the customer pays on the business's own checkout (or the agent pays directly, over x402); the order arrives in the system the business already runs; and the customer collects with a signed QR that staff scan. Businesses in any industry connect the point of sale they already have (Square today, more systems on the way), or run with no POS and take cards through their own Stripe account. The money goes straight to the business, never through agentPickup, and a dashboard shows it what sells and what people ask for nearby.

agentPickup adds what the agent payment standards don't cover: a way for agents to order from physical businesses (x402, MPP, UCP, ACP, an MCP server and a public directory) and proof that the right person collected the order. The step-by-step guide for agents is [AGENTS.md](https://agentpickup.app/AGENTS.md).

## Order for a user

- [Add to your assistant](https://agentpickup.app/add): one page that adds agentPickup to Claude (an install link), ChatGPT or Grok, then starts an order at a shop. A shop's own QR adds `?shop=<slug>`.
- [MCP server](https://agentpickup.app/mcp): streamable HTTP. Tools to find shops, read a menu, ask about a shop (dietary needs, allergies, hours, parking), order, pay, check status, fetch the pickup pass, and run group orders. In chat apps that show cards (MCP Apps), the order appears as a card that becomes the pickup pass and updates itself until it's collected; the shop emails the pass as well. A cards-only version, with no USDC tools, is at `https://agentpickup.app/mcp/cards`. Also `npx -y @agentpickup/mcp`, and in the official MCP Registry as `io.github.dav3trad3r/agentpickup`.
- [Shop directory](https://agentpickup.app/directory/v1/shops): shops by `q` (what the user wants), `place` (a suburb), or `lat` and `lng` with `radius_km`; add `open_now=true` for shops open now. Each result's `url` is that shop's address.
- [Order and pay in one call](https://agentpickup.app/api/x402/order?items=babyccino:1): x402, USDC on Base. `items` takes `id:qty` pairs, comma-separated, and the paid response carries the pickup pass. This one is the Demo Café, a demo shop: the payment is real, but nothing is made.
- [Demo Café on the test network](https://agentpickup.app/v/demo-cafe-testnet/api/catalog): the same menu, paid in testnet USDC on Base Sepolia. Both demo cafés also take free test payments (`"rail": "test"`, or `payment: "test"` in the MCP tools), which run the whole flow with no money moving.
- [Square Sandbox Café](https://agentpickup.app/v/square-sandbox-cafe/api/catalog): for trying a card payment. Its checkout page takes Square's test card 4111 1111 1111 1111 (any future expiry, any CVV); nothing is charged.
- [OpenAPI](https://agentpickup.app/openapi.json): a shop's routes, with `x-payment-info` on the paid ones.
- [Agent skill](https://github.com/Tokenise-au/agentpickup-sdk/blob/main/skills/agentpickup/SKILL.md): the same steps as a skill, installed with `npx skills add Tokenise-au/agentpickup-sdk`.

## Shop files

Every shop serves these under its own address. The Demo Café is at https://agentpickup.app, and shops that signed up are at https://agentpickup.app/v/{shop}.

- [Catalog](https://agentpickup.app/api/catalog): the menu, prices, pickup location and payment methods.
- [Listing](https://agentpickup.app/.well-known/agentpickup.json): the shop's directory listing.
- [UCP profile](https://agentpickup.app/.well-known/ucp) and [ACP discovery](https://agentpickup.app/.well-known/acp.json): checkout for Google's and OpenAI's agent protocols.
- [Pass keys](https://agentpickup.app/.well-known/collect-keys.json): the public keys (JWKS) that verify a pickup pass offline.

## For shops and developers

- [Sign up a shop](https://agentpickup.app/connect): connect the shop's POS (Square today), or [start with an email](https://agentpickup.app/connect/email) with no POS: the menu is built on the dashboard and cards go through the shop's own Stripe
- [Give an agent a wallet](https://agentpickup.app/wallet)
- [Open code](https://github.com/Tokenise-au/agentpickup-sdk): the pickup pass spec and library (`@agentpickup/core`), the MCP server (`@agentpickup/mcp`) and the agent skill.
- [Docs](https://agentpickup.app/docs), in three guides:
  - [People](https://agentpickup.app/docs/people): adding agentPickup to an assistant, ordering (now or for a pickup time), paying, collecting and cancelling; the tools; demo shops to try it.
  - [Businesses](https://agentpickup.app/docs/businesses): setting up with a POS or none, items and stock, taking orders, handing over, refunds, the dashboard and getting paid.
  - [Developers](https://agentpickup.app/docs/developers): the MCP server and its settings, the order API, agent checkout protocols, the pickup pass, the directory and the machine-readable files.
- [FAQ](https://agentpickup.app/faq): questions from shoppers (paying, collecting, who sees what) and shops (joining, getting paid, the dashboard), answered.
- [Support](https://agentpickup.app/support), [Terms](https://agentpickup.app/terms), [Privacy](https://agentpickup.app/privacy)
- [agentPickup on X](https://x.com/agentPickup): news, new shops and new features
- [agentPickup on LinkedIn](https://www.linkedin.com/company/agentpickup): company news, pilots and partners