AgentPay

x402 micropayments MCP: Xiaohongshu notes and paid APIs settled in USDC on Base.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "agentpay-8": {
      "command": "npx",
      "args": [
        "-y",
        "agentpay-8"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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）

config.json

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

只需填付款钱包私钥（需有 USDC）。网关地址已内置，一般不用改。

或永久安装：

Terminal

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）

How it works

Code

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:

Terminal

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.

bash

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

bash

# 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

bash

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about AgentPay

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "agentpay": { "command": "npx", "args": ["-y", "AgentPay"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/agentpay-8?style=directory)](https://allmcps.com/mcp/agentpay-8)

HTML Embed

<a href="https://allmcps.com/mcp/agentpay-8"><img src="https://allmcps.com/api/badge/agentpay-8?style=directory" alt="AgentPay on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge and attach your website — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to AgentPay →Install in Claude Desktop Install in Cursor Install in VS Code

AgentPay

x402 micropayments MCP: Xiaohongshu notes and paid APIs settled in USDC on Base.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

{
  "mcpServers": {
    "agentpay-8": {
      "command": "npx",
      "args": [
        "-y",
        "agentpay-8"
      ]
    }
  }
}

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Documentation Overview

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）

config.json

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

只需填付款钱包私钥（需有 USDC）。网关地址已内置，一般不用改。

或永久安装：

Terminal

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）

How it works

Code

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:

Terminal

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.

bash

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

bash

# 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

bash

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

Read the full README →View source on GitHub →

Related MCP Servers

View all in Finance & Fintech View all alternatives

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about AgentPay

Add the following block to your claude_desktop_config.json under mcpServers: "mcpServers": { "agentpay": { "command": "npx", "args": ["-y", "AgentPay"] } }

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/agentpay-8?style=directory)](https://allmcps.com/mcp/agentpay-8)

HTML Embed

<a href="https://allmcps.com/mcp/agentpay-8"><img src="https://allmcps.com/api/badge/agentpay-8?style=directory" alt="AgentPay on AllMCPs" /></a>

Technical Specs & Signals

CategoryFinance & Fintech

27Quality signal: Emerging · 27/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership8/20

Documentation & tools11/30

Adoption & activity1/15

Community engagement0/10

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 💰 Finance & Fintech →Best MCP servers for Finance & Fintech →Alternatives to AgentPay →Install in Claude Desktop Install in Cursor Install in VS Code

AgentPay

Quick Install

Client Config & Setup

Documentation Overview

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

Related MCP Servers

Reviews

Frequently Asked Questions about AgentPay

AllMCPs Directory Badge

Technical Specs & Signals

Feature Your MCP Server

Own this project?

Share & Embed

Explore more

AgentPay

Quick Install

Client Config & Setup

Documentation Overview

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

Related MCP Servers

Reviews

Frequently Asked Questions about AgentPay

AllMCPs Directory Badge

Technical Specs & Signals

Feature Your MCP Server

Own this project?

Share & Embed

Explore more

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

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