AgentPay

AgentPay MCP サーバー

x402 + MCP によるエージェント間マイクロペイメント — AI エージェントが Base 上の USDC で API アクセス料金を自律的に支払えるようにします。

インストール

オプション A — リモート MCP（おすすめ、ローカルへのインストール不要）

Cursor／Claude／Streamable HTTP に対応する任意のクライアントに追加します。

https://agentpay-xhs-production.up.railway.app/mcp

公式 Registry エントリー：io.github.yyxqqq777/agentpay

オプション B — ローカル stdio（uvx / PyPI）

{
  "mcpServers": {
    "agentpay": {
      "command": "uvx",
      "args": ["mcp-server-agentpay"],
      "env": {
        "AGENT_PRIVATE_KEY": "0xYourAgentPrivateKey"
      }
    }
  }
}

支払い用ウォレットの秘密鍵（USDC を保有している必要があります）を入力するだけです。ゲートウェイのアドレスは組み込み済みのため、通常は変更不要です。

または、永続的にインストールします。

pip install mcp-server-agentpay
# or
uv tool install mcp-server-agentpay

ツール

ツール	説明	料金
xhs_get_note_detail	Xiaohongshu の投稿詳細	0.01 USDC／回
xhs_get_user_notes	Xiaohongshu ユーザーの投稿一覧	0.01 USDC／回
china_wholesale_pricing_query	工場直販の卸売価格（1688／Yiwu）	0.01 USDC／回
agentpay_payment_status	支払い設定、ウォレット、支出上限を確認	無料

プロンプトの例

• 「この小紅書の投稿には何が書かれているか確認してください：https://www.xiaohongshu.com/explore/...」
• 「このブロガーが最近投稿した内容を取得してください。user_id=...」
• 「3 ドル未満のワイヤレスイヤホンの卸売価格を検索してください」
• 「AgentPay ウォレットと支出上限を教えてください」

環境変数

変数	必須	説明
AGENT_PRIVATE_KEY	はい（有料ツール）	支払い用ウォレットの秘密鍵
MAX_SPEND_PER_CALL	いいえ	1 回あたりの上限（デフォルトは 0.10）
GATEWAY_BASE_URL	いいえ	ゲートウェイのアドレス（デフォルトで公開 Gateway を指定）

動作の仕組み

MCP Client  →  mcp-server-agentpay  →  x402 Gateway  →  Paid API
              (auto 402 → sign → retry)   (verify USDC)

1. ツール呼び出しが有料 API エンドポイントに到達します
2. Gateway が USDC の支払い情報とともに 402 Payment Required を返します
3. MCP サーバーが支払いに署名し、自動的に再試行します
4. JSON データが LLM に返されます

Gateway のセルフホスト

有料 API を運用している場合は、Gateway を個別にデプロイします。

pip install "mcp-server-agentpay[gateway]"
# .env: PAYMENT_MODE=production + upstream keys + your receive wallet
agentpay-gateway

実際の USDC 決済（x402）

モード	動作
PAYMENT_MODE=demo	ローカルの疑似決済（開発専用）
PAYMENT_MODE=production	公式 Facilitator によるオンチェーンの検証 + 決済

テストネット（Base Sepolia） — https://x402.org/facilitator とネットワーク eip155:84532 を使用します。

# Fund a test agent with Sepolia USDC, then:
PYTHONPATH=src python scripts/test_x402_settlement.py

メインネット — PAYMENT_NETWORK=eip155:8453 とメインネット用 Facilitator（https://api.cdp.coinbase.com/platform/v2/x402 または PayAI）を設定します。USDC は WALLET_RECIPIENT_ADDRESS に送金されます。

.env.example を参照してください。

MCP Registry への公開

このパッケージは公式 MCP Registry向けに設計されています。

# 1. Publish to PyPI
pip install build twine
python -m build && twine upload dist/*

# 2. Publish to MCP Registry (packages + remotes)
./scripts/publish_all.sh

または GitHub Release（v0.1.0）を作成します。Actions が Trusted Publishing を使用して PyPI に公開した後、Registry を更新します。

公開する前に、server.json と README の mcp-name を GitHub の名前空間（io.github.<username>/agentpay）に更新してください。

開発

git clone https://github.com/yyxqqq777/mcp-server-agentpay
cd mcp-server-agentpay
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest tests/ -v

ライセンス

MIT