agentPickup

io.github.dav3trad3r由 GitHub 帳號 dav3trad3r 發布v0.3.1更新於 Nov 5, 2026

Find pickup shops near you, order, pay by card or USDC (x402), and get the QR to collect in person.

發布方自己的服務:Useful Work

已驗證Streamable HTTP可網頁執行位置與生活金融商業與電商

概覽

AI 產生的概覽

讓助理尋找附近的到店自取商店、下單、以信用卡或 USDC(x402)付款,並交付到店取貨的 QR 憑證。

可以做什麼
  • 依座標、地名或關鍵字尋找商店,含地址、營業時間、距離與符合的商品
  • 查看商店的商品與價格、取貨地點及可用的付款方式
  • 建立到店自取訂單,可用錢包付款或取得信用卡結帳連結
  • 透過 x402 以 USDC 支付訂單,並取回取貨憑證、取貨碼與 QR
  • 處理團體訂單:發起並分享代碼、加入並支付自己那份、查看狀態、提前關閉
適用情境
適合使用者想在線上購買、再到當地商店自取的情境,例如辦公室咖啡團購或就近取貨,並願意以信用卡或加密錢包付款。也適合多人各自付款的團體訂單。
執行需求
可使用 agentpickup.app 的遠端端點,或在本機執行 npm 套件,需 Node 22.13 以上版本。本機使用需設定 AGENTPICKUP_SHOP_URL,實際付款還需持有 USDC 的 AGENTPICKUP_WALLET_KEY;AGENTPICKUP_MAX_PER_ORDER、AGENTPICKUP_NETWORKS 與 AGENTPICKUP_DIRECTORY_URL 為選用。取貨 QR 需寄到使用者電子郵件。
安裝前請注意
pay_order 會從設定的錢包花用真實資金;未設定 AGENTPICKUP_WALLET_KEY 時僅回傳報價。該金鑰是私鑰,請使用只放少量、可承受代理花費的資金的錢包,並將 AGENTPICKUP_MAX_PER_ORDER 設低。下單會把使用者電子郵件提供給商店,團體訂單會分享加入代碼。付款前請與使用者確認商品與總額。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 agentPickup,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.github.dav3trad3r%2Fagentpickup/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "agentpickup": {
      "type": "http",
      "url": "https://agentpickup.app/mcp"
    }
  }
}

README

@agentpickup/mcp

An MCP server for agentPickup shops. It lets an AI agent find pickup shops near its user, see what they sell, order, pay by card or in USDC over x402, and hand its user the QR they show at the counter to collect.

Tools

ToolWhat it does
find_shopsShops 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_shopItems and prices, the pickup location, and how the shop takes payment
create_pickup_orderCreates an order. Needs the user's email, where the shop sends the receipt and pickup QR. 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_orderPays 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
order_statusWaiting for payment, paid, ready, collected or expired
get_pickup_passFetches the pass link, pickup code and QR again by signing in as the paying wallet (Sign-In-With-X)
start_group_orderStarts a group order (a coffee run) with a closing time; returns the code to share and a key to close it early
join_group_orderAdds the user's items to a group order by its code; pay the share with pay_order before it closes
group_order_statusWho's in, what they ordered, who has paid, and whether the shop's order is ready or collected
close_group_orderCloses a group order early, as its organiser; the shop gets one combined order and the organiser its QR

Use it

Try it against the hosted demo shop first. It pays with the demo's own small wallet, within the demo's caps:

json
{ "mcpServers": { "agentpickup": { "type": "http", "url": "https://agentpickup.app/mcp" } } }

Or run it locally against any agentPickup shop, with your own wallet:

json
{  "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"      }    }  }}
SettingDefault
AGENTPICKUP_SHOP_URLthe demo shopThe shop to order from. Tool calls can also name another shop with shop_url
AGENTPICKUP_WALLET_KEYnoneAn EVM private key holding USDC. Without it, pay_order only quotes
AGENTPICKUP_MAX_PER_ORDER$25The most the wallet pays for one order
AGENTPICKUP_NETWORKSeip155:84532Networks the wallet may pay on. Base Sepolia (test USDC) unless you add eip155:8453 for Base mainnet
AGENTPICKUP_DIRECTORY_URLhttps://agentpickup.app/directory/v1/shopsWhere 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

ts
import { createMcpHandler, walletPayer } from "@agentpickup/mcp";
const mcp = createMcpHandler({ shopUrl: "https://orders.yourshop.com" }); // no wallet: pay_order quotesapp.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).

來源:packages/mcp/README.md,提交 f70d35d

工具

10

find_shops

Find pickup 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.

輸入參數latlnglimitplacequeryopen_nowradius_km

get_shop

See what a shop sells

What the shop sells (item ids and prices), where to collect, and which payments it takes.

輸入參數shop_url

create_pickup_order

Order for pickup

Create an order to collect in person. Returns the order id and total; pay it with pay_order. The shop emails the pickup QR to `email` once it's paid. Where the shop takes cards, `payment: "card"` returns a checkout link for the user to pay on instead.

輸入參數nameemail必填items必填paymentshop_url

pay_order

Pay for an order

Pay an order in USDC over x402 from wallet 0xd253e213cE143Aa0E1e1cAfc92f7AE82c98aB3bB. This spends money: confirm the items and total with the user first. Returns the pickup pass link.

輸入參數order_id必填shop_url

order_status

Check an order

Whether an order is waiting for payment, paid, ready to collect, collected or expired.

輸入參數order_id必填shop_url

get_pickup_pass

Get the pickup pass

The pass link, pickup code and QR content for an order this wallet paid, by signing in with the wallet (Sign-In-With-X).

輸入參數order_id必填shop_url

start_group_order

Start a group order

Start a group order (a coffee run) at a shop. 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.

輸入參數titleshop_urlorganiser_name必填organiser_email必填closes_in_minutes

join_group_order

Join a 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.

輸入參數code必填name必填email必填items必填shop_url

group_order_status

Check a group order

Who's in a group order, what they ordered, who has paid, and whether it has closed and been collected.

輸入參數code必填shop_url

close_group_order

Close a group order now

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

輸入參數code必填shop_urlorganiser_key必填

版本歷史

3
  1. v0.3.1最新Nov 5, 2026
  2. v0.2.0Nov 3, 2026
  3. v0.1.1Nov 3, 2026

評分

已滿足適用檢查項的 90%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。

其他 Usefulwork 整合