AgentPay

AgentPay MCP 服务

通过 x402 + MCP 实现 Agent 间小额支付 — 让 AI Agent 使用 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	小红书笔记详情	0.01 USDC/次调用
xhs_get_user_notes	小红书用户发布的笔记列表	0.01 USDC/次调用
china_wholesale_pricing_query	工厂直供批发价格（1688/义乌）	0.01 USDC/次调用
agentpay_payment_status	查看付款配置、钱包和支出限额	免费

提示词示例

• "帮我看看这条小红书笔记写了什么：https://www.xiaohongshu.com/explore/..."
• "拉一下这个博主最近发的笔记，user_id=..."
• "搜索价格低于 $3 的无线耳机批发价"
• "我的 AgentPay 钱包和支出限额是多少？"

环境变量

变量	必需	描述
AGENT_PRIVATE_KEY	是（付费工具）	付款钱包私钥
MAX_SPEND_PER_CALL	否	单次上限（默认 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 数据返回给大模型

自托管 Gateway

如果你运营付费 API，可单独部署网关：

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

使用 x402 进行真实 USDC 结算

模式	行为
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