Lets AI agents find local shops, answer menu questions, place orders, and handle payments for in-person collection.
Also known as Tokenise-au/agentpickup-sdk, @agentpickup/mcp
- Stars
- 0
- Tools
- 38
- Downloads, 30 days
- 3,799
- Latest version
- 0.7.4
- Last commit
- Nov 12, 2026
- License
- —
What is agentPickup MCP?
agentPickup lets AI agents find local shops, answer menu questions, place orders, and handle payments for in-person collection. It exposes 38 tools, such as find_shops, get_shop, ask_about_shop.
Summary generated from the project's README
About agentPickup MCP server
Ordering food and goods from local businesses through an AI assistant is what agentPickup enables. This MCP server allows users to discover nearby shops, inquire about specific menu details like allergies or parking, and place orders for in-person collection. It supports both remote setups via an HTTP connection to a hosted server and local installations using npx with specific environment variables like AGENTPICKUP_SHOP_URL and AGENTPICKUP_WALLET_KEY.
Developers can integrate this into clients to handle complex workflows such as group orders for office lunches or managing dietary notes. Payments are handled through card checkout links or via USDC using an x402 wallet. The server provides tools like find_shops for discovery, ask_about_shop for nuanced questions, and create_pickup_order to initiate transactions. When used in chat applications that support MCP cards, the server can display interactive pickup passes containing QR codes and real-time order status updates.
What you can do with it
- 1Finding nearby food optionsAsk your assistant to locate shops in a specific suburb or those selling a particular item.
- 2Clarifying dietary requirementsInquire about specific ingredients or allergies that are not explicitly listed on a digital menu.
- 3Organizing team lunchesCoordinate a group order where multiple people can add their items before a set closing time.
Written from the project's README. Every use case is checked against a quote from it.
How to install agentPickup MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall agentPickup MCP in Claude Code
$ claude mcp add --env 'AGENTPICKUP_WALLET_KEY=<YOUR_AGENTPICKUP_WALLET_KEY>' agentpickup -- npx -y @agentpickup/mcpInstall agentPickup MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"agentpickup": {
"command": "npx",
"args": [
"-y",
"@agentpickup/mcp"
],
"env": {
"AGENTPICKUP_WALLET_KEY": "<YOUR_AGENTPICKUP_WALLET_KEY>"
}
}
}
}Install agentPickup MCP in VS Code
.vscode/mcp.json
{
"servers": {
"agentpickup": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@agentpickup/mcp"
],
"env": {
"AGENTPICKUP_WALLET_KEY": "<YOUR_AGENTPICKUP_WALLET_KEY>"
}
}
}
}Install agentPickup MCP in VS Code CLI
$ code --add-mcp '{"name":"agentpickup","type":"stdio","command":"npx","args":["-y","@agentpickup/mcp"],"env":{"AGENTPICKUP_WALLET_KEY":"<YOUR_AGENTPICKUP_WALLET_KEY>"}}'Install agentPickup MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"agentpickup": {
"command": "npx",
"args": [
"-y",
"@agentpickup/mcp"
],
"env": {
"AGENTPICKUP_WALLET_KEY": "<YOUR_AGENTPICKUP_WALLET_KEY>"
}
}
}
}Install agentPickup MCP in Codex
$ codex mcp add agentpickup --env 'AGENTPICKUP_WALLET_KEY=<YOUR_AGENTPICKUP_WALLET_KEY>' -- npx -y @agentpickup/mcpInstall agentPickup MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.agentpickup] command = "npx" args = ["-y", "@agentpickup/mcp"] [mcp_servers.agentpickup.env] AGENTPICKUP_WALLET_KEY = "<YOUR_AGENTPICKUP_WALLET_KEY>"
Install agentPickup MCP in Gemini CLI
$ gemini mcp add -s user -e 'AGENTPICKUP_WALLET_KEY=<YOUR_AGENTPICKUP_WALLET_KEY>' agentpickup npx -- -y @agentpickup/mcpInstall agentPickup MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"agentpickup": {
"command": "npx",
"args": [
"-y",
"@agentpickup/mcp"
],
"env": {
"AGENTPICKUP_WALLET_KEY": "<YOUR_AGENTPICKUP_WALLET_KEY>"
}
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for @agentpickup/mcp 0.7.4 in an isolated container with no network and no keys. It answered and listed 14 tools.
agentPickup MCP tools 38
Read from the server with tools/listfind_shopsRead-onlyFind 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_shopRead-onlyWhat 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.
ask_about_shopRead-onlyAnswer 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).
create_pickup_orderActionCreate 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.
pay_orderActionGet 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.
order_statusRead-onlyCheck 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.
set_dietary_noteActionAdd 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.
cancel_pickup_orderActionCancel 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.
get_pickup_passRead-onlyGet 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.
share_agentpickupRead-onlyA 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_group_orderActionStart 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.
join_group_orderActionAdd 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.
| find_shops | 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 |
| get_shop | 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 |
| ask_about_shop | 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). | Read-only |
| create_pickup_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. | Action |
| pay_order | 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. | Action |
| order_status | 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. | Read-only |
| set_dietary_note | 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. | Action |
| cancel_pickup_order | 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. | Action |
| get_pickup_pass | 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 |
| share_agentpickup | 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 |
| start_group_order | 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. | Action |
| join_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. | Action |
Show all 38 toolsShow fewer tools
group_order_statusRead-onlyCheck 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.
close_group_orderActionClose a group order early, as its organiser. Unpaid shares are left out; the shop gets the rest as one order.
my_accountRead-onlyShows 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.
set_my_nameActionSets 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.
start_sellingActionSets 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 photo ID), and there's no Stripe login to set up; agentPickup shows them their money afterwards (my_payouts). business is a registered business that wants its own full Stripe account and dashboard. Ask the person if it isn't clear. A listing can only go up once this is finished. Call again for a fresh link. Needs sign-in.
create_listingActionDrafts 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 description from what the person tells you and shows you: honest, including faults, and never invent details. Leave out phone numbers, emails and links. If they don't give a price, suggest a fair one and check it with them. The draft shows as a listing card; the person adds photos and signs the seller declaration themselves to put it up. Needs sign-in.
add_listing_photosActionChatGPT 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). Location and camera details are removed from every photo. Needs sign-in.
publish_listingActionSigns 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_link emails them a page to sign instead). The person must be signed in, set up to be paid (start_selling), and the listing needs a photo. A listing that mentions something checked by hand (food, knives, batteries, recalls) is held for agentPickup's check, usually within a day, instead of going straight up. Returns the listing card.
email_publish_linkActionEmails 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.
my_listingsRead-onlyThe person's own listings on agentPickup, newest first, with where each one is up to. Needs sign-in.
end_listingActionTakes 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 later, open it with get_listing and they sign again in the card, or change it first with create_listing and its listing_id. Needs sign-in.
remove_listing_photoActionTakes 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 sign-in.
search_listingsRead-onlySearches 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; returns each item's listing_id, title, price, condition, suburb, distance and first photo.
get_listingRead-onlyShows one listing as a card: photos, price, condition, description, suburb and pickup times. The seller sees their own draft.
see_listing_photosRead-onlyShows 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.
buy_listingActionBuys 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.
ask_sellerActionAsks 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 seller is emailed if they don't read it within a couple of minutes; their answer appears in this conversation (open_deal) and the person is emailed when it arrives. Send only what the person asked, in their words. Needs sign-in.
make_offerActionOffers 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 amount the person chose. Needs sign-in.
answer_offerActionAnswers 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.
open_dealRead-onlyOpens 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-in.
message_dealActionSends 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 it soon. Needs sign-in.
cancel_purchaseActionCancels 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 after the handover. Needs sign-in.
my_payoutsRead-onlyWhat 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 where they see their money: present it however suits them (a table, totals, a chart). If Stripe needs anything more from them, start_selling gives a fresh Stripe link. Needs sign-in.
my_dealsRead-onlyThe 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.
create_alertActionSets 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.
my_alertsActionLists the person's alerts for items on agentPickup's marketplace; with stop_alert_id, stops that one first. Needs sign-in.
| group_order_status | 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. | Read-only |
| close_group_order | Close a group order early, as its organiser. Unpaid shares are left out; the shop gets the rest as one order. | Action |
| my_account | 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 |
| set_my_name | 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. | Action |
| start_selling | 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 photo ID), and there's no Stripe login to set up; agentPickup shows them their money afterwards (my_payouts). business is a registered business that wants its own full Stripe account and dashboard. Ask the person if it isn't clear. A listing can only go up once this is finished. Call again for a fresh link. Needs sign-in. | Action |
| create_listing | 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 description from what the person tells you and shows you: honest, including faults, and never invent details. Leave out phone numbers, emails and links. If they don't give a price, suggest a fair one and check it with them. The draft shows as a listing card; the person adds photos and signs the seller declaration themselves to put it up. Needs sign-in. | Action |
| add_listing_photos | 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). Location and camera details are removed from every photo. Needs sign-in. | Action |
| publish_listing | 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_link emails them a page to sign instead). The person must be signed in, set up to be paid (start_selling), and the listing needs a photo. A listing that mentions something checked by hand (food, knives, batteries, recalls) is held for agentPickup's check, usually within a day, instead of going straight up. Returns the listing card. | Action |
| email_publish_link | 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. | Action |
| my_listings | The person's own listings on agentPickup, newest first, with where each one is up to. Needs sign-in. | Read-only |
| end_listing | 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 later, open it with get_listing and they sign again in the card, or change it first with create_listing and its listing_id. Needs sign-in. | Action |
| remove_listing_photo | 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 sign-in. | Action |
| search_listings | 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; returns each item's listing_id, title, price, condition, suburb, distance and first photo. | Read-only |
| get_listing | Shows one listing as a card: photos, price, condition, description, suburb and pickup times. The seller sees their own draft. | Read-only |
| see_listing_photos | 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 |
| buy_listing | 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. | Action |
| ask_seller | 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 seller is emailed if they don't read it within a couple of minutes; their answer appears in this conversation (open_deal) and the person is emailed when it arrives. Send only what the person asked, in their words. Needs sign-in. | Action |
| make_offer | 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 amount the person chose. Needs sign-in. | Action |
| answer_offer | 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. | Action |
| open_deal | 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-in. | Read-only |
| message_deal | 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 it soon. Needs sign-in. | Action |
| cancel_purchase | 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 after the handover. Needs sign-in. | Action |
| my_payouts | 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 where they see their money: present it however suits them (a table, totals, a chart). If Stripe needs anything more from them, start_selling gives a fresh Stripe link. Needs sign-in. | Read-only |
| my_deals | 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 |
| create_alert | 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. | Action |
| my_alerts | Lists the person's alerts for items on agentPickup's marketplace; with stop_alert_id, stops that one first. Needs sign-in. | Action |
Configuration
AGENTPICKUP_WALLET_KEYSecretPrivate 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
AGENTPICKUP_DIRECTORY_URLWhere find_shops searches (default the agentpickup.app directory); off to leave it out
AGENTPICKUP_MAX_PER_ORDERMost the wallet pays for one order, e.g. $25
AGENTPICKUP_NETWORKSComma-separated CAIP-2 networks the wallet may pay on (default eip155:84532)
AGENTPICKUP_SHOP_URLThe agentPickup shop to order from
| Name | Description | |
|---|---|---|
| AGENTPICKUP_WALLET_KEY | 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 | Secret |
| AGENTPICKUP_DIRECTORY_URL | Where find_shops searches (default the agentpickup.app directory); off to leave it out | |
| AGENTPICKUP_MAX_PER_ORDER | Most the wallet pays for one order, e.g. $25 | |
| AGENTPICKUP_NETWORKS | Comma-separated CAIP-2 networks the wallet may pay on (default eip155:84532) | |
| AGENTPICKUP_SHOP_URL | The agentPickup shop to order from |
Automated checks
Ran Nov 16, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work · What to fix for more points
- Source repository linked and reachabletokenise-au/agentpickup-sdk is public and reachablegithub.com/tokenise-au/agentpickup-sdk ↗Pass
- Package names this repository as its source@agentpickup/mcp names tokenise-au/agentpickup-sdk as sourcenpmjs.com/package/@agentpickup/mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)No licenseFinding
- Commit or release in the last yearLast commit or release 2026-11-12github.com/tokenise-au/agentpickup-sdk ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @agentpickup/mcpPass
- No critical advisory in the package or its dependenciesthe package checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model38 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledDestructive tools carry destructiveHintPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-11-25 in 610 ms; tools/list returned 38 toolsPass
README
View on GitHub@agentpickup/mcp
An MCP server for agentPickup: people order from real shops through their AI assistant and collect in person. It lets the assistant find shops near its user, see what they sell, answer questions the menu doesn't (dietary needs, allergies, hours, parking), order, and have the user pay by card on the shop's own checkout (or pay in USDC over x402 from an agent wallet). The order lands on the shop's own POS, and the user collects with the QR they show at the counter.
Tools
| Tool | What it does |
|---|---|
find_shops |
Shops near a point (lat/lng), in a suburb (place) or selling something (query), from the agentPickup directory: each one's shop_url, address, hours, open now, distance and matching items |
get_shop |
Items and prices with their options (a milk, an extra shot: ids, extra cost, defaults), the pickup location, whether it's open, its social accounts, how the shop takes payment, whether it takes dietary notes, and how long a paid order waits to be collected |
ask_about_shop |
Questions the menu doesn't answer: dietary needs and allergies, reviews, opening hours, where it is, parking, wait times, prices. Answers from what the shop has said, and says plainly what it hasn't. Send the question without names or personal details: the shop sees only which topics people ask about |
create_pickup_order |
Creates an order and returns a claim to keep with it. Needs the user's email, where the shop sends the receipt and pickup pass. Each item takes its chosen option ids; dietary_note passes the user's dietary needs to the shop, where it takes them. pickup_at orders for later ("17:30", "5:30pm" or an ISO time, in the shop's own time zone, when it's open, up to 7 days ahead); left out, it's as soon as possible. A test shop marks it paid straight away, with no money moving. Where the shop takes cards, payment: "card" returns a checkout link for the user to pay on instead |
pay_order |
Pays the order's x402 link from your wallet and returns the pass link. With no wallet set up, returns the price and pay link instead. For a card order, returns its checkout link |
cancel_pickup_order |
Cancels an order with its claim. An unpaid one 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. After that, the user asks staff |
order_status |
Waiting for payment, paid, ready, collected, expired or cancelled. With the order's claim, a paid order's pass comes back too |
get_pickup_pass |
Fetches the pass link, pickup code and QR again: with the order's claim, or by signing in as the paying wallet (Sign-In-With-X) |
set_dietary_note |
Adds or changes an unpaid order's dietary note (with its claim); the order's card shows it. Once paid, the user tells staff instead |
start_group_order |
Starts a group order (a team lunch, an office order) with a closing time; returns the code to share and a key to close it early |
join_group_order |
Adds the user's items to a group order by its code; pay the share with pay_order before it closes |
group_order_status |
Who's in, what they ordered, who has paid, and whether the shop's order is ready or collected |
share_agentpickup |
A QR and link for friends to add agentPickup to their assistant (as a card where the chat shows cards), for everyone or with one shop picked |
close_group_order |
Closes a group order early, as its organiser; the shop gets one combined order and the organiser its QR |
The pickup pass card
In chat apps that draw MCP Apps cards (Claude and ChatGPT
among them), create_pickup_order, order_status and get_pickup_pass show the order as a card: a Pay button while
it's unpaid, then the QR and pickup code, kept up to date until it's collected. When the shop marks it ready, the QR's
tile turns lime. The card is one self-contained page (ui://agentpickup/pass-<version>.html) that loads nothing from
anywhere else. In apps without cards, the agent gives the user the pass link and pickup code. The shop emails the pass
either way. The card's "Invite a friend" link, and share_agentpickup's own card, point at the add page
(addPageUrl, default https://agentpickup.app/add) so friends can add it too.
Use it
Try it against the hosted demo shops first. The hosted server holds no wallet: its demo shops take a free test payment, the Square sandbox's test card, or USDC from the user's own x402 wallet:
{ "mcpServers": { "agentpickup": { "type": "http", "url": "https://agentpickup.app/mcp" } } }
Or run it locally against any agentPickup shop, with your own wallet:
{
"mcpServers": {
"agentpickup": {
"command": "npx",
"args": ["-y", "@agentpickup/mcp"],
"env": {
"AGENTPICKUP_SHOP_URL": "https://orders.yourshop.com",
"AGENTPICKUP_WALLET_KEY": "0x…",
"AGENTPICKUP_MAX_PER_ORDER": "$25"
}
}
}
}
| Setting | Default | |
|---|---|---|
AGENTPICKUP_SHOP_URL |
the demo shop | The shop to order from. Tool calls can also name another shop with shop_url |
AGENTPICKUP_WALLET_KEY |
none | The private key of a wallet used only for this, holding just the USDC you mean to spend: never your main wallet. Without it, pay_order only quotes |
AGENTPICKUP_MAX_PER_ORDER |
$25 |
The most the wallet pays for one order |
AGENTPICKUP_NETWORKS |
eip155:84532 |
Networks the wallet may pay on. Base Sepolia (test USDC) unless you add eip155:8453 for Base mainnet |
AGENTPICKUP_DIRECTORY_URL |
https://agentpickup.app/directory/v1/shops |
Where find_shops searches. off leaves the tool out |
Use a wallet that holds only what you're willing to let an agent spend. The tools tell the model to confirm items and the total with the user before paying.
Host it in your own server
import { createMcpHandler, walletPayer } from "@agentpickup/mcp";
const mcp = createMcpHandler({ shopUrl: "https://orders.yourshop.com" }); // no wallet: pay_order quotes
// `instructions` adds your own notes to what agents read on connecting, e.g. which of your shops take what.
app.all("/mcp", (c) => mcp(c.req.raw)); // Streamable HTTP, stateless, any Request/Response runtime
Node 22.13 or later. Licence: FSL-1.1-ALv2 (free to use and self-host; becomes Apache-2.0 two years after each release).
agentPickup MCP questions
How do I add agentPickup MCP to Claude Code?
Run claude mcp add --env 'AGENTPICKUP_WALLET_KEY=<YOUR_AGENTPICKUP_WALLET_KEY>' agentpickup -- npx -y @agentpickup/mcp in your terminal. Add --scope user to make it available in every project.
How do I add agentPickup MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does agentPickup MCP provide?
It exposes 38 tools, including find_shops, get_shop, ask_about_shop, create_pickup_order, pay_order.
Can the AI answer questions about dietary needs?
Yes, the assistant can ask about dietary needs, allergies, and other details not listed on the menu.
How is the order collected at the shop?
The user collects their order in person by showing a QR code or pickup pass at the counter.
Is there a way to order for a group?
Yes, the server supports starting group orders for team lunches or office orders with a shared code.