{"id":"io.github.dav3trad3r/agentpickup","slug":"io-github-dav3trad3r-agentpickup","title":"agentPickup","description":"Lets AI agents buy from physical businesses: find, order, pay, and collect in person with a QR.","version":"0.7.4","publisher":{"kind":"github","id":"dav3trad3r","label":"@dav3trad3r on GitHub","url":"https://github.com/dav3trad3r"},"website":"https://agentpickup.app","repository":"https://github.com/Tokenise-au/agentpickup-sdk","remotes":[{"type":"streamable-http","url":"https://agentpickup.app/mcp"}],"packages":[{"registryType":"npm","identifier":"@agentpickup/mcp","version":"0.7.4","transport":{"type":"stdio"},"environmentVariables":[{"description":"The agentPickup shop to order from","format":"string","name":"AGENTPICKUP_SHOP_URL"},{"description":"Private key of a wallet used only for this, holding just what you mean to spend in USDC. It pays over x402, up to AGENTPICKUP_MAX_PER_ORDER per order. Without it, pay_order only quotes","format":"string","isSecret":true,"name":"AGENTPICKUP_WALLET_KEY"},{"description":"Most the wallet pays for one order, e.g. $25","format":"string","name":"AGENTPICKUP_MAX_PER_ORDER"},{"description":"Comma-separated CAIP-2 networks the wallet may pay on (default eip155:84532)","format":"string","name":"AGENTPICKUP_NETWORKS"},{"description":"Where find_shops searches (default the agentpickup.app directory); off to leave it out","format":"string","name":"AGENTPICKUP_DIRECTORY_URL"}]}],"published":"2026-11-12","updated":"2026-11-12","status":"online","auth":"","latency_ms":1177,"checked":"2026-11-19","uptime":100,"checks":3,"tools":[{"name":"find_shops","title":"Find pickup shops","description":"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.","read_only":true},{"name":"get_shop","title":"See what a shop sells","description":"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.","read_only":true},{"name":"ask_about_shop","title":"Ask about a shop","description":"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 ","read_only":true},{"name":"create_pickup_order","title":"Order for pickup","description":"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.","read_only":false},{"name":"pay_order","title":"Pay for an order","description":"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.","read_only":false},{"name":"order_status","title":"Check an order","description":"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 use","read_only":true},{"name":"set_dietary_note","title":"Add a dietary note","description":"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.","read_only":false},{"name":"cancel_pickup_order","title":"Cancel an order","description":"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.","read_only":false},{"name":"get_pickup_pass","title":"Get the pickup pass","description":"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.","read_only":true},{"name":"share_agentpickup","title":"Share agentPickup","description":"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.","read_only":true},{"name":"start_group_order","title":"Start a group order","description":"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.","read_only":false},{"name":"join_group_order","title":"Join a group order","description":"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.","read_only":false},{"name":"group_order_status","title":"Check a group order","description":"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_o","read_only":true},{"name":"close_group_order","title":"Close a group order now","description":"Close a group order early, as its organiser. Unpaid shares are left out; the shop gets the rest as one order.","read_only":false},{"name":"my_account","title":"My agentPickup account","description":"Shows the agentPickup account the person is signed in with, and whether they can sell items yet. Needs the person to sign in to agentPickup; the assistant shows the sign-in button.","read_only":true},{"name":"set_my_name","title":"Set the name others see","description":"Sets the name the person shows buyers and sellers on agentPickup's marketplace, in deal chats and on their listings: a first name or nickname they choose (letters only, up to 30). Never their email or phone. Needs sign-in.","read_only":false},{"name":"start_selling","title":"Set up to sell on agentPickup","description":"Sets the person up to be paid for what they sell on agentPickup's marketplace, through Stripe, and returns the link to Stripe's sign-up. Give the person the link: they complete it themselves, and the assistant never handles their details. seller_type casual (the usual case) is a person selling their own things: Stripe asks only for their name, date of birth, address and bank account (sometimes pho","read_only":false},{"name":"create_listing","title":"Draft a listing","description":"Drafts a listing for something the person wants to sell on agentPickup's marketplace, or changes one of their drafts (pass listing_id). Physical goods only, handed over in person: no services, rentals, tickets, vouchers, gift cards, digital items, weapons, drugs, vapes, alcohol, animals, fireworks or vehicles (the full rules: https://agentpickup.app/marketplace-rules). Write the title and descript","read_only":false},{"name":"add_listing_photos","title":"Add photos to a listing","description":"ChatGPT only: adds photos the person attached in the chat to one of their draft listings (up to 8 in all), which ChatGPT passes as files with download links. Never use photos from the web or anywhere else: a listing shows the seller's own item. Other assistants can't pass attached photos to a tool: give the person the listing's upload page link instead (create_listing and get_listing return it). L","read_only":false},{"name":"publish_listing","title":"Sign and publish","description":"Signs the seller declaration and puts one of the person's draft listings up for sale on agentPickup's marketplace for 30 days, where buyers can find, ask about, offer on and buy it. Only the listing card calls this, when the person ticks the declaration and presses Sign and publish: it's hidden from assistants, so a person always signs for themselves (where the card can't be shown, email_publish_l","read_only":false},{"name":"email_publish_link","title":"Email the sign-and-publish link","description":"Emails the person a link to read the seller declaration, sign it and put their listing up. Use it when they can't see the listing card (it needs a photo first). Needs sign-in.","read_only":false},{"name":"my_listings","title":"My listings","description":"The person's own listings on agentPickup, newest first, with where each one is up to. Needs sign-in.","read_only":true},{"name":"end_listing","title":"Take a listing down","description":"Takes one of the person's own listings off agentPickup's marketplace, for example when they've sold it elsewhere or changed their mind: buyers can no longer find, offer on or buy it. Works on a draft, a listing waiting for a check, or a live one; an item someone is paying for or has bought can't be taken down (use cancel_purchase for that sale). Confirm with the person first. To put it back up lat","read_only":false},{"name":"remove_listing_photo","title":"Remove a photo from a listing","description":"Takes one photo off one of the person's listings: a wrong, blurry or doubled one, or one that doesn't match the description. photo_id is the photo's id (ph_...) or its address, as get_listing's card or see_listing_photos gives it. Check with the person first. If the listing was up, it goes back to a draft for them to sign again. The card's photo strip has a remove button for each photo too. Needs ","read_only":false},{"name":"search_listings","title":"Search items for sale","description":"Searches things people are selling on agentPickup's marketplace, picked up in person: by words, category, top price and distance. Items are collected in person, so before searching for someone, ask where they are and how far they're happy to travel if they haven't said, then pass near (a suburb) or lat/lng, with within_km. Shows the results as a grid card the person can tap to open an item; return","read_only":true},{"name":"get_listing","title":"Show an item for sale","description":"Shows one listing as a card: photos, price, condition, description, suburb and pickup times. The seller sees their own draft.","read_only":true},{"name":"see_listing_photos","title":"Look at an item's photos","description":"Shows you a listing's photos (up to 4), so you can check them against the description or answer the person's questions about how the item looks. The person already sees them on the card; this is for you.","read_only":true},{"name":"buy_listing","title":"Buy an item","description":"Buys an item from agentPickup's marketplace at its listed price, for the person to pick up in person. Reserves it for 30 minutes and returns Stripe's payment page: the person pays there themselves. Their card is held, not charged, until they collect the item and the seller confirms the handover. Check the item and the price with them first. Needs sign-in.","read_only":false},{"name":"ask_seller","title":"Ask the seller a question","description":"Asks the seller of an item on agentPickup's marketplace a question before buying: is it still available, its condition, sizes, whether it fits. Opens a private conversation between the person and the seller, shown as a card; the seller gets an email if they don't read it soon. Contact details, other apps and links aren't shared until the person buys, and payment only goes through agentPickup. The ","read_only":false},{"name":"make_offer","title":"Make an offer","description":"Offers the seller less than the asking price for an item on agentPickup's marketplace, in the person's conversation with them. If the seller has set a lowest price and the offer reaches it, it's accepted on the spot and the item is reserved for the person to pay on Stripe's page; otherwise the seller accepts, counters or declines (within 24 hours). Up to 3 offers on an item a day. Offer only the a","read_only":false},{"name":"answer_offer","title":"Answer an offer","description":"Answers an offer in a conversation about an item: the seller accepts, declines or counters a buyer's offer (a counter is between the offer and the price); the buyer accepts or declines the seller's counter. Accepting lets the buyer buy at that price within 24 hours. Only what the person decided. Needs sign-in.","read_only":false},{"name":"open_deal","title":"Open a deal's chat","description":"Opens the chat for one of the person's purchases or sales, where buyer and seller arrange the pickup: messages, the agreed pickup time and the address; or a conversation of questions before buying (enq_ ids). Shows it as a card. Without sale_id, their most recent one. agentPickup never shares either side's contact details; they share what they choose in the chat once the buyer has paid. Needs sign","read_only":true},{"name":"message_deal","title":"Send a message in a deal's chat","description":"Sends something in a deal's chat, to the other side: a message, a proposed pickup time, accepting the other side's proposed time, or (the seller only) the pickup address. Send only what the person asked you to, in their words. Payment only goes through agentPickup: messages asking for another payment, and links, aren't sent. The other side sees it in their chat and gets an email if they don't read","read_only":false},{"name":"cancel_purchase","title":"Cancel a purchase or sale","description":"Cancels a purchase before the handover, when the person (the buyer, or the seller) asks to. The buyer's card was only held, so the hold is released and nothing is charged, and the other side is told. When the buyer cancels, the item goes back on sale; when the seller cancels, the listing comes down unless put_back_on_sale. Confirm with the person first, then pass confirmed: true. Not possible afte","read_only":false},{"name":"my_payouts","title":"My sales money","description":"What the person has made selling on agentPickup's marketplace: each item handed over, with its price, agentPickup's 2.5% fee, Stripe's card fee, what they got and when it reaches their Stripe balance; payments still held until a handover; and, from Stripe, their balance, recent payouts to their bank and the bank account (last four digits only). Casual sellers have no Stripe dashboard, so this is w","read_only":true},{"name":"my_deals","title":"My purchases and sales","description":"The person's purchases and sales on agentPickup's marketplace and where each is up to: waiting for payment, paid (with the buyer's pickup pass, or the seller's handover code), collected, or released. Needs sign-in.","read_only":true},{"name":"create_alert","title":"Watch for an item","description":"Sets an alert on agentPickup's marketplace for something the person wants that isn't listed yet (or that they want more of): words, a category, a top price, and a place and distance. When a matching item is listed, they get an email. Up to 10 alerts; my_alerts lists or stops them. Needs sign-in.","read_only":false},{"name":"my_alerts","title":"My alerts","description":"Lists the person's alerts for items on agentPickup's marketplace; with stop_alert_id, stops that one first. Needs sign-in.","read_only":false}],"server_info":{"name":"agentpickup","title":"agentPickup","version":"0.7.4","websiteUrl":"https://agentpickup.app","icons":[{"src":"https://agentpickup.app/logo.png","mimeType":"image/png","sizes":["1024x1024"]}]},"category":"ecommerce","tags":["agents","image-video","sales"],"kind":"remote","source":"registry","submitted":{},"first_party":false,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-11-03","stars":0,"badges":["new"],"sponsor":null,"page":"https://agentsindex.org/agents/io-github-dav3trad3r-agentpickup/"}