llms.txt
1 field changed
- file
-
absentpublished
https://agentpickup.app/llms.txt
+ # 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 (Squ+ 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`, and `https://a+ - [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`.+ ## Buy and sell with people+ - [Marketplace tools](https://agentpickup.app/docs/people#market-tools): on the hosted MCP servers only, not the npm package. `search_listings`, `get_listing` and `see_listing_photos` need no account; `ask_seller`, `make_offer`, `answer_offer`, `buy_listing`, `my_deals`, `open_deal`, `message_deal`, `cancel_purchase`, `create_alert`, `my_alerts`, `create_listing`, `remove_listing_photo`, `email_publish_link`, `my_listings`, `end_listing`, `start_selling`, `my_payouts`, `my_account` and `set_my_n+ - How it works: `buy_listing` reserves the item for 30 minutes and returns Stripe's payment page on the seller's own Stripe account. The card is held, not charged, until the seller scans the buyer's QR at the pickup and types their handover code; it's released if the item isn't handed over within 5 days. The seller pays agentPickup's 2.5% fee. Sellers sign the seller declaration themselves, in the listing card.+ - [Marketplace rules](https://agentpickup.app/marketplace-rules): what can't be sold (alcohol, animals, weapons, vapes and more), listing rules, meeting safely, scams and reporting.+ ## 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; buying and selling with people; 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, marketplace sign-in (OAuth), 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), people buying and selling with each other, 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