agentPickup

Answer a question about a shop that its menu doesn't: dietary needs and allergies (gluten-free, vegan, nuts), reviews, opening hours, where it is, parking, wait times, prices. Use it whenever the user asks something like that about a shop. Send the question in a few words, without names or other personal details. It answers from what the shop has said, says plainly what the shop hasn't, and tells the shop which topics people ask about (never the question itself).

Cancel a pickup order when the user asks, with the claim create_pickup_order returned. An unpaid order just closes. A paid one can be cancelled until the shop starts making it, and what was paid goes back the way it was paid (a card refund can take a few business days to show). Once the shop has started it, or it's ready, the user asks staff at the counter instead.

Close a group order early, as its organiser. Unpaid shares are left out; the shop gets the rest as one order.

Create an order to collect in person. Returns the order id, total and a claim (keep it); pay it with pay_order. The shop emails the pickup pass to `email` once it's paid, and where the chat shows cards the order shows as one that becomes the pass. Where the shop takes cards, `payment: "card"` returns a checkout link for the user to pay on instead.

Find agentPickup shops to order from: near a point (lat/lng), in a suburb or city (place), or selling something (query). Returns each shop's shop_url, pickup address, hours, whether it's open now, distance, and matching menu items.

Get the pickup pass again for a paid order, when the user asks for their QR, pickup code or pass link (lost the email, closed the card). Returns the pass link, the six-character pickup code and the QR, shown as the pass card. Needs the claim create_pickup_order returned. An unpaid order has no pass yet: to see where an order is up to, use order_status instead.

What the shop sells (item ids and prices, with photos, dietary labels, allergens, what's sold out, and what's in stock where the shop's POS counts it), where to collect, and which payments it takes. In chat apps that show cards, the menu appears as a card with the photos.

Check a group order by its code, when the user asks who's in, what's been ordered or whether it has closed. Returns each person's name, items and whether they've paid, the total paid so far, when it closes, and, once it has closed, the status of the shop's combined order (paid, ready or collected). Anyone with the code can check it; it changes nothing. To add the user's own items, use join_group_order; to close it early as the organiser, use close_group_order.

Add the user's items to a group order with its code. Returns the order id; pay it with pay_order before the group closes. The organiser collects everything, so the user gets a receipt, not a QR.

Check where an order is up to, when the user asks if it's paid or ready, or before telling them to go and collect. Returns its status (waiting for payment, paid, being made, ready to collect, collected, expired or cancelled), and the checkout link while it's unpaid. Works with the order id alone. With the claim, a paid order's pass comes back as well and the chat's order card updates. When the user only wants their QR or pickup code again, use get_pickup_pass instead.

Get the payment details for an order made with create_pickup_order. No wallet is set up in this server, so it pays nothing: for an x402 order it returns the USDC price and pay link for another x402 client to pay; for a card order, the checkout link for the user to pay on.

Add or change the dietary note on an order before it's paid (an allergy, an intolerance, in the user's words), at a shop that takes dietary notes. An empty note removes it. The order's card shows it within a few seconds. Once the order is paid it's with the shop already: the user tells staff at the counter instead.

A QR code and link the user can share so friends can add agentPickup to Claude, ChatGPT or Grok and order too. Use when the user asks how to share agentPickup, invite friends, or get others using it. Name a shop to share it with that shop picked.

Start a group order (a team lunch, an office order) at a shop, when the user wants to order together with others now. Returns a code to share: each person's agent joins with it and pays for their own items. When it closes, the shop gets one combined order and the organiser is emailed its pickup QR. To share agentPickup itself with a friend, use share_agentpickup instead.