AgentPay MCP Server

Agent-to-Agent micropayments via x402 + MCP — let AI agents autonomously pay for API access with USDC on Base.

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-agentpay

Tools

Tool	Description	Cost
`xhs_get_note_detail`	Xiaohongshu note detail	0.01 USDC/call
`xhs_get_user_notes`	Xiaohongshu user posted notes list	0.01 USDC/call
`china_wholesale_pricing_query`	Factory-direct wholesale pricing (1688/Yiwu)	0.01 USDC/call
`agentpay_payment_status`	View payment config, wallet, and spending limits	Free

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

Variable	Required	Description
`AGENT_PRIVATE_KEY`	Yes（付费工具）	付款钱包私钥
`MAX_SPEND_PER_CALL`	No	单次上限（默认 `0.10`）
`GATEWAY_BASE_URL`	No	网关地址（默认已指向公网 Gateway）
`PAYMENT_MODE`	Gateway	`demo` 或 `production`
`DATAFLOW_API_TOKEN` / `TIKHUB_API_KEY`	仅 Gateway 部署	上游数据源（不对 Agent 暴露）

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-gateway

Real USDC settlement (x402)

Mode	Behavior
`PAYMENT_MODE=demo`	Local fake pay (dev only)
`PAYMENT_MODE=production`	Official Facilitator verify + settle on-chain

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.py

Mainnet — set PAYMENT_NETWORK=eip155:8453 and a mainnet facilitator (https://api.cdp.coinbase.com/platform/v2/x402 or PayAI). USDC goes to WALLET_RECIPIENT_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.sh

Or 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.<username>/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/ -v

License

MIT

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_server_agentpay-0.1.2.tar.gz (20.9 kB view details)

Uploaded Sep 7, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

mcp_server_agentpay-0.1.2-py3-none-any.whl (28.6 kB view details)

Uploaded Sep 7, 2026 Python 3

File details

Details for the file mcp_server_agentpay-0.1.2.tar.gz.

File metadata

Download URL: mcp_server_agentpay-0.1.2.tar.gz
Upload date: Sep 7, 2026
Size: 20.9 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mcp_server_agentpay-0.1.2.tar.gz
Algorithm	Hash digest
SHA256	`3ae732ae1afac7902d22a67647dbe97ad32799931128117bcb030d99bd350e0a`
MD5	`45166f7718f51220ee27763b9a92d772`
BLAKE2b-256	`6800fb497510e4dd1476529cdb0f89e3607f7e769bdf2be41df80275f54bf052`

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_server_agentpay-0.1.2.tar.gz:

Publisher: publish.yml on yyxqqq777/mcp-server-agentpay

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: mcp_server_agentpay-0.1.2.tar.gz
- Subject digest: 3ae732ae1afac7902d22a67647dbe97ad32799931128117bcb030d99bd350e0a
- Sigstore transparency entry: 2747158705
- Sigstore integration time: Sep 7, 2026
Source repository:
- Permalink: yyxqqq777/mcp-server-agentpay@d7d82e574af1648d10c2c1e18fba3123e81702cc
- Branch / Tag: refs/tags/v0.1.2
- Owner: https://github.com/yyxqqq777
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@d7d82e574af1648d10c2c1e18fba3123e81702cc
- Trigger Event: release

File details

Details for the file mcp_server_agentpay-0.1.2-py3-none-any.whl.

File metadata

Download URL: mcp_server_agentpay-0.1.2-py3-none-any.whl
Upload date: Sep 7, 2026
Size: 28.6 kB
Tags: Python 3
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for mcp_server_agentpay-0.1.2-py3-none-any.whl
Algorithm	Hash digest
SHA256	`ddf92a741a935792a4ba5d8f48a6f1bb4082d59e7cc81948ff7b2ce1f55e6d0a`
MD5	`594b45984678d6a53ce126a8e81cfe1c`
BLAKE2b-256	`9481ff6df0471d3fe11912a322b2133808f2162b3c8d211f926e2b119b64c3ed`

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_server_agentpay-0.1.2-py3-none-any.whl:

Publisher: publish.yml on yyxqqq777/mcp-server-agentpay

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: mcp_server_agentpay-0.1.2-py3-none-any.whl
- Subject digest: ddf92a741a935792a4ba5d8f48a6f1bb4082d59e7cc81948ff7b2ce1f55e6d0a
- Sigstore transparency entry: 2747159331
- Sigstore integration time: Sep 7, 2026
Source repository:
- Permalink: yyxqqq777/mcp-server-agentpay@d7d82e574af1648d10c2c1e18fba3123e81702cc
- Branch / Tag: refs/tags/v0.1.2
- Owner: https://github.com/yyxqqq777
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@d7d82e574af1648d10c2c1e18fba3123e81702cc
- Trigger Event: release

Release history Release notifications | RSS feed

0.1.3

Sep 7, 2026 2 files

This release

0.1.2 This release

Sep 7, 2026 2 files

0.1.1

Sep 7, 2026 2 files

0.1.0

Sep 7, 2026 2 files

mcp-server-agentpay 0.1.2

AgentPay MCP Server

Install

Option A — Remote MCP（推荐，无需本地安装）

Option B — 本地 stdio（`uvx` / PyPI）

Tools

Example prompts

Environment Variables

How it works

Self-host the Gateway

Real USDC settlement (x402)

Publish to MCP Registry

Development

License

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed

mcp-server-agentpay 0.1.2

AgentPay MCP Server

Install

Option A — Remote MCP（推荐，无需本地安装）

Option B — 本地 stdio（uvx / PyPI）

Tools

Example prompts

Environment Variables

How it works

Self-host the Gateway

Real USDC settlement (x402)

Publish to MCP Registry

Development

License

Project links

Key dates

1 maintainer

Credits

GitHub Statistics

License

Requires

Provides Extra

Tags

Classifiers

Download files

Source Distribution

Built Distribution

File details

File metadata

File hashes

Provenance

File details

File metadata

File hashes

Provenance

Release history Release notifications | RSS feed

Option B — 本地 stdio（`uvx` / PyPI）