agentPickup

@agentpickup/mcp

agentPickup のショップ向け MCP サーバーです。AI エージェントは、ユーザーの近くにある受け取り可能なショップを探し、販売商品を確認し、注文して、カードまたは x402 経由の USDC で支払い、カウンターで提示する QR コードをユーザーに渡すことができます。

ツール

ツール	機能
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	パスリンク、受け取りコード、QR コードを再取得します。注文の claim を指定するか、支払いに使ったウォレットでサインインします（Sign-In-With-X）
start_group_order	終了時刻を指定してグループ注文（コーヒーの買い出し）を開始し、共有用のコードと、早期に終了するためのキーを返します
join_group_order	コードを使ってユーザーの商品をグループ注文に追加します。終了前に pay_order で自分の分を支払います
group_order_status	参加者、注文内容、支払い済みの参加者、ショップの注文が準備完了か受け取り済みかを返します
share_agentpickup	友人がアシスタントに agentPickup を追加するための QR コードとリンクを返します。チャットにカードを表示できる場合はカードとして表示されます。すべての人向け、または特定のカフェを選んだ状態で共有できます
close_group_order	主催者としてグループ注文を早期終了します。ショップにはまとめて1件の注文が送られ、主催者には QR コードが渡されます

受け取りパスカード

MCP Apps のカードを表示できるチャットアプリ（Claude や ChatGPT など）では、create_pickup_order、order_status、get_pickup_pass が注文をカードとして表示します。支払い前は「支払う」ボタンが表示され、支払い後は QR コードと受け取りコードが表示され、受け取りが完了するまで最新の状態に保たれます。ショップが準備完了にすると、QR コードのタイルがライム色に変わります。カードは単独で動作する1つのページ（ui://agentpickup/pass-<version>.html）で、外部から何も読み込みません。カードに対応していないアプリでは、エージェントがユーザーにパスリンクと受け取りコードを渡します。どちらの場合も、ショップからパスがメールで送られます。カードの「友人を招待」リンクと、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	ウォレットが1回の注文に支払う上限額です
AGENTPICKUP_NETWORKS	eip155:84532	ウォレットで支払い可能なネットワークです。Base Sepolia（テスト用 USDC）が既定です。Base メインネットを使う場合は eip155:8453 を追加してください
AGENTPICKUP_DIRECTORY_URL	https://agentpickup.app/directory/v1/shops	find_shops が検索する場所です。off にするとツールは含まれません

エージェントに使わせてもよい金額だけを保有するウォレットを使用してください。ツールは、支払い前に商品と合計金額をユーザーに確認するようモデルに指示します。

独自のサーバーでホストする

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（無料で利用およびセルフホスト可能です。各リリースから2年後に Apache-2.0 になります）。