agentPickup

@agentpickup/mcp

适用于 agentPickup 商店的 MCP 服务。它可让 AI Agent 查找用户附近的取货商店、查看商店售卖的商品、下单、使用银行卡或通过 x402 以 USDC 付款，并把用户在柜台出示的二维码交给用户取货。

工具

工具	功能
find_shops	从 agentPickup 目录中查找商店：可按位置点（lat/lng）、郊区（place）或商品（query）搜索；每家商店都会显示其 shop_url、地址、营业时间、当前是否营业、距离和匹配的商品
get_shop	商品和价格、取货地点，以及商店支持的付款方式
create_pickup_order	创建订单并返回用于关联订单的 claim。需要用户的电子邮箱，商店会将收据和取货凭证发送到该邮箱。测试商店会立即将订单标记为已付款，不会发生实际资金转移。如果商店支持银行卡付款，设置 payment: "card" 会返回结账链接，供用户自行付款
pay_order	使用你的钱包支付订单的 x402 链接，并返回取货凭证链接。未设置钱包时，会改为返回价格和付款链接。银行卡订单则会返回其结账链接
order_status	等待付款、已付款、已备好、已取货或已过期。提供订单的 claim 后，也会返回已付款订单的取货凭证
get_pickup_pass	再次获取取货凭证链接、取货码和二维码：可提供订单的 claim，也可使用付款钱包登录（Sign-In-With-X）
start_group_order	发起团购（例如咖啡订购），并设置截止时间；返回可分享的代码和用于提前关闭团购的密钥
join_group_order	根据团购代码将用户的商品加入团购；团购截止前，使用 pay_order 支付相应份额
group_order_status	查看参与者、订购的商品、已付款的参与者，以及商店订单是否已备好或已取货
share_agentpickup	为好友提供二维码和链接，让他们将 agentPickup 添加到自己的助手中（如果聊天支持卡片，则以卡片形式显示）；可面向所有人，也可指定一家咖啡馆
close_group_order	以组织者身份提前关闭团购；商店会收到一笔合并订单，组织者会收到二维码

取货凭证卡片

在可显示 MCP Apps 卡片的聊天应用（包括 Claude 和 ChatGPT）中，create_pickup_order、order_status 和 get_pickup_pass 会将订单显示为卡片：未付款时显示“付款”按钮，付款后显示二维码和取货码，并持续更新，直到订单被取走。商店将订单标记为已备好时，二维码区域会变为青柠绿。该卡片是一个独立页面（ui://agentpickup/pass-<version>.html），不会从其他位置加载任何内容。在不支持卡片的应用中，Agent 会向用户提供取货凭证链接和取货码。无论使用哪种方式，商店都会通过电子邮件发送取货凭证。卡片上的“邀请好友”链接以及 share_agentpickup 自带的卡片，都会指向添加页面（addPageUrl，默认为 https://agentpickup.app/add），方便好友也添加它。

使用方法

先用托管的演示商店进行测试。托管服务端不持有钱包：演示商店接受免费的测试付款、Square 沙盒的测试卡，或用户自己的 x402 钱包中的 USDC：

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

或者在本地运行，使用自己的钱包连接任意 agentPickup 商店：

{
  "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"
      }
    }
  }
}

设置项	默认值
AGENTPICKUP_SHOP_URL	演示商店	要下单的商店。工具调用也可通过 shop_url 指定其他商店
AGENTPICKUP_WALLET_KEY	无	持有 USDC 的 EVM 私钥。未设置时，pay_order 只会提供报价
AGENTPICKUP_MAX_PER_ORDER	$25	钱包为单笔订单支付的最高金额
AGENTPICKUP_NETWORKS	eip155:84532	钱包可用于付款的网络。默认使用 Base Sepolia（测试 USDC）；添加 eip155:8453 可启用 Base 主网
AGENTPICKUP_DIRECTORY_URL	https://agentpickup.app/directory/v1/shops	find_shops 搜索的目录。设为 off 可移除此工具

使用只存放你愿意让 Agent 支出的资金的钱包。这些工具会提示模型在付款前与用户确认商品和总金额。

在自己的服务器上托管

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 或更高版本。许可证：FSL-1.1-ALv2（可免费使用和自托管；每个版本发布两年后变为 Apache-2.0）。