AgentPay MCP server
not respondingio.github.yyxqqq777/agentpay·v0.1.3x402 micropayments MCP: Xiaohongshu notes and paid APIs settled in USDC on Base.
0 stars35 downloads/wk
Reviews
Write oneNobody has reviewed AgentPay yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
AgentPay tools (4)
write = sends, deletes, buys or postsagentpay_payment_statusFreeReturn AgentPay payment configuration without charging: network, price, spending limit, payment mode, gateway URL, and agent wallet address. Call this before paid tools to verify the wallet is configured, or after a payment error.
china_wholesale_pricing_queryFreeSearch factory-direct wholesale pricing samples for a product keyword (1688 / Yiwu style catalog). Returns items with MOQ, unit price USD, factory location, and supplier verification flags. Use for China sourcing research. Settles ~0.01 USDC via x402 per query.
xhs_get_note_detailFreeFetch one Xiaohongshu (小红书) note by share URL or 24-char note_id and return title, description, author, engagement stats, images, and video URL as JSON. Call this when the user pastes an xiaohongshu.com/explore link or a note id. Settles ~0.01 USDC via x402 on each successful call.
xhs_get_user_notesFreeList posted notes for a Xiaohongshu user_id (paginated). Returns note summaries and next_cursor for pagination. Use when the user asks for a creator's recent posts. Settles ~0.01 USDC via x402 per page.
Public scan report
scanner v0.1.10 · 2026-10-12 · same rubric, same numbers if you re-run it
- Code scan20 source files scanned25/25
- Live reliabilityremote unreachable: Streamable HTTP error: Error POSTing to endpoint: {"status":"error","code":404,"message":"Application not found","request_id":"wZNDa9mZR_O8PjS18u2xcg"}0/20
- –Tool poisoningtools not inspected (endpoint requires auth); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 35 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Findings (1)
- highRemote endpoint did not respond
reliability.unreachableStreamable HTTP error: Error POSTing to endpoint: {"status":"error","code":404,"message":"Application not found","request_id":"wZNDa9mZR_O8PjS18u2xcg"}
How AgentPay compares
Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 60/100
- higher than 15% of 48,243 servers
- Tools
- 4
- the typical server has 7
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 0%
- of our recent checks; the typical remote server answers 100%
- Response time
- 79 ms
- faster than 88% of 30,027 servers
- Downloads a week
- 35
- more than 24% of 12,306 servers with a package
What its tools let an agent do: 4 read
Install AgentPay in Claude Code, Cursor or VS Code
claude mcp add --transport http agentpay https://agentpay-xhs-production.up.railway.app/mcp
What the publisher says
From the AgentPay repository's README, as published. We do not edit it. Read it on GitHub
AgentPay MCP Server
Agent-to-Agent micropayments via x402 + MCP — let AI agents autonomously pay for API access with USDC on Base.
<!-- mcp-name: io.github.yyxqqq777/agentpay -->
Install
Option A — Remote MCP(推荐,无需本地安装)
在 Cursor / Claude / 任意支持 Streamable HTTP 的客户端添加:
https://agentpay-xhs-production.up.railway.app/mcp
官方 Registry 条目:io.github.yyxqqq777/agentpay
Option 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-agentpayTools
Example prompts
- "帮我看看这条小红书笔记写了什么:https://www.xiaohongshu.com/explore/..."
- "拉一下这个博主最近发的笔记,user_id=..."
- "Search wholesale prices for wireless earbuds under $3"
- "What's my AgentPay wallet and spending limit?"
Environment Variables
How it works
MCP Client → mcp-server-agentpay → x402 Gateway → Paid API
(auto 402 → sign → retry) (verify USDC)- Tool call hits a paid API endpoint
- Gateway returns 402 Payment Required with USDC payment details
- MCP server signs payment and retries automatically
- JSON data flows back to the LLM
Self-host the Gateway
If you operate the paid API, deploy the gateway separately:
pip install "mcp-server-agentpay[gateway]"
# .env: PAYMENT_MODE=production + upstream keys + your receive wallet
agentpay-gatewayReal USDC settlement (x402)
Testnet (Base Sepolia) — use https://x402.org/facilitator, network eip155:84532.
# Fund a test agent with Sepolia USDC, then:
PYTHONPATH=src python scripts/test_x402_settlement.pyMainnet — set PAYMENTNETWORK=eip155:8453 and a mainnet facilitator (https://api.cdp.coinbase.com/platform/v2/x402 or PayAI). USDC goes to WALLETRECIPIENT_ADDRESS.
See .env.example.
Publish to MCP Registry
This package is designed for the official 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.shOr create a GitHub Release (v0.1.0) — Actions uses Trusted Publishing to PyPI then updates the Registry.
Before publishing, update server.json and README mcp-name with your GitHub namespace (io.github./agentpay).
Development
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/ -vLicense
MIT
Nothing above is checked by us. What we check is on the safety report.
Grade history
- 2026-10-12downgradeA → Cscore 60: Remote endpoint did not respond
AgentPay: common questions
- Is AgentPay MCP server safe?
- With care: it is graded C, so read the findings first (60/100). Read the AgentPay safety report
- How do I install AgentPay?
- It runs remotely at agentpay-xhs-production.up.railway.app. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does AgentPay need an API key?
- Yes. The registry entry asks for
AGENT_PRIVATE_KEY. - Is AgentPay maintained?
- The last commit was 59 days ago (2026-09-07). The latest release is v0.1.3.
- Is AgentPay up?
- 0% of our last 28 checks got an answer. We check remote servers about four times a day.
- How does AgentPay compare with other MCP servers?
- safety score 60/100 (higher than 15% of 48,243 servers); tools 4 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.