mcp-server-agentpay 0.1.0__tar.gz

mcp_server_agentpay-0.1.0/.gitignore

@@ -0,0 +1,15 @@
+__pycache__/
+*.py[cod]
+*.egg-info/
+.venv/
+venv/
+.env
+dist/
+build/
+server.remotes-only.json
+mcp-publisher
+.pytest_cache/
+.ruff_cache/
+.mypy_cache/
+*.log
+.DS_Store

mcp_server_agentpay-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AgentPay Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

mcp_server_agentpay-0.1.0/PKG-INFO

@@ -0,0 +1,206 @@
+Metadata-Version: 2.5
+Name: mcp-server-agentpay
+Version: 0.1.0
+Summary: MCP server for x402 micropayments — query paid APIs with autonomous USDC payments on Base
+Project-URL: Homepage, https://github.com/yyxqqq777/mcp-server-agentpay
+Project-URL: Repository, https://github.com/yyxqqq777/mcp-server-agentpay
+Project-URL: Documentation, https://github.com/yyxqqq777/mcp-server-agentpay#readme
+Project-URL: Issues, https://github.com/yyxqqq777/mcp-server-agentpay/issues
+Author-email: yyx <yunxuan517@gmail.com>
+License: MIT
+License-File: LICENSE
+Keywords: agents,base,mcp,micropayments,model-context-protocol,usdc,x402
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.10
+Requires-Dist: eth-account>=0.13.0
+Requires-Dist: httpx>=0.28.0
+Requires-Dist: mcp>=1.0.0
+Requires-Dist: pydantic-settings>=2.6.0
+Requires-Dist: pydantic>=2.10.0
+Requires-Dist: python-dotenv>=1.0.0
+Provides-Extra: dev
+Requires-Dist: fastapi>=0.115.0; extra == 'dev'
+Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
+Requires-Dist: pytest>=8.0.0; extra == 'dev'
+Requires-Dist: ruff>=0.8.0; extra == 'dev'
+Requires-Dist: uvicorn[standard]>=0.32.0; extra == 'dev'
+Requires-Dist: web3>=7.0.0; extra == 'dev'
+Requires-Dist: x402[evm,fastapi,httpx]>=2.0.0; extra == 'dev'
+Provides-Extra: gateway
+Requires-Dist: fastapi>=0.115.0; extra == 'gateway'
+Requires-Dist: uvicorn[standard]>=0.32.0; extra == 'gateway'
+Requires-Dist: web3>=7.0.0; extra == 'gateway'
+Requires-Dist: x402[evm,fastapi,httpx]>=2.0.0; extra == 'gateway'
+Provides-Extra: wallet
+Requires-Dist: web3>=7.0.0; extra == 'wallet'
+Provides-Extra: x402
+Requires-Dist: x402[evm,fastapi,httpx]>=2.0.0; extra == 'x402'
+Description-Content-Type: text/markdown
+
+# 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）
+
+```json
+{
+  "mcpServers": {
+    "agentpay": {
+      "command": "uvx",
+      "args": ["mcp-server-agentpay"],
+      "env": {
+        "GATEWAY_BASE_URL": "https://agentpay-xhs-production.up.railway.app",
+        "AGENT_PRIVATE_KEY": "0xYourAgentPrivateKey",
+        "MAX_SPEND_PER_CALL": "0.10",
+        "PYTHONUNBUFFERED": "1"
+      }
+    }
+  }
+}
+```
+
+或永久安装：
+
+```bash
+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?"
+
+## Agent Skill（可发布 · agentskills.io）
+
+符合 [Agent Skills](https://agentskills.io)。对外只暴露 **AgentPay 付费小红书接口**，Agent 不知道、也不应调用任何上游爬虫：
+
+```
+Agent / MCP  --(x402 0.01 USDC)-->  AgentPay Gateway  -->  笔记 JSON
+                                   收款: 你的 Base 钱包
+```
+
+```bash
+npx skills-ref validate ./skills/xhs-note-fetch
+
+# 本地：Gateway 持有上游密钥；Agent 侧只配 GATEWAY_BASE_URL
+PYTHONPATH=src python -m agentpay.gateway.app
+GATEWAY_BASE_URL=http://127.0.0.1:8402 \
+  python skills/xhs-note-fetch/scripts/fetch_note.py "<笔记链接>"
+```
+
+发布 `skills/xhs-note-fetch` 即可。上游密钥只写在 Gateway 部署环境。
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `GATEWAY_BASE_URL` | MCP / Skill | AgentPay 网关地址 |
+| `AGENT_PRIVATE_KEY` | Production | 付款钱包私钥 |
+| `MAX_SPEND_PER_CALL` | No | 单次上限（默认 `0.10`） |
+| `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)
+```
+
+1. Tool call hits a paid API endpoint
+2. Gateway returns `402 Payment Required` with USDC payment details
+3. MCP server signs payment and retries automatically
+4. JSON data flows back to the LLM
+
+## Self-host the Gateway
+
+If you operate the paid API, deploy the gateway separately:
+
+```bash
+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`](.env.example).
+
+## Publish to MCP Registry
+
+This package is designed for the [official MCP Registry](https://registry.modelcontextprotocol.io).
+
+```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

mcp_server_agentpay-0.1.0/README.md

@@ -0,0 +1,160 @@
+# 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）
+
+```json
+{
+  "mcpServers": {
+    "agentpay": {
+      "command": "uvx",
+      "args": ["mcp-server-agentpay"],
+      "env": {
+        "GATEWAY_BASE_URL": "https://agentpay-xhs-production.up.railway.app",
+        "AGENT_PRIVATE_KEY": "0xYourAgentPrivateKey",
+        "MAX_SPEND_PER_CALL": "0.10",
+        "PYTHONUNBUFFERED": "1"
+      }
+    }
+  }
+}
+```
+
+或永久安装：
+
+```bash
+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?"
+
+## Agent Skill（可发布 · agentskills.io）
+
+符合 [Agent Skills](https://agentskills.io)。对外只暴露 **AgentPay 付费小红书接口**，Agent 不知道、也不应调用任何上游爬虫：
+
+```
+Agent / MCP  --(x402 0.01 USDC)-->  AgentPay Gateway  -->  笔记 JSON
+                                   收款: 你的 Base 钱包
+```
+
+```bash
+npx skills-ref validate ./skills/xhs-note-fetch
+
+# 本地：Gateway 持有上游密钥；Agent 侧只配 GATEWAY_BASE_URL
+PYTHONPATH=src python -m agentpay.gateway.app
+GATEWAY_BASE_URL=http://127.0.0.1:8402 \
+  python skills/xhs-note-fetch/scripts/fetch_note.py "<笔记链接>"
+```
+
+发布 `skills/xhs-note-fetch` 即可。上游密钥只写在 Gateway 部署环境。
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `GATEWAY_BASE_URL` | MCP / Skill | AgentPay 网关地址 |
+| `AGENT_PRIVATE_KEY` | Production | 付款钱包私钥 |
+| `MAX_SPEND_PER_CALL` | No | 单次上限（默认 `0.10`） |
+| `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)
+```
+
+1. Tool call hits a paid API endpoint
+2. Gateway returns `402 Payment Required` with USDC payment details
+3. MCP server signs payment and retries automatically
+4. JSON data flows back to the LLM
+
+## Self-host the Gateway
+
+If you operate the paid API, deploy the gateway separately:
+
+```bash
+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`](.env.example).
+
+## Publish to MCP Registry
+
+This package is designed for the [official MCP Registry](https://registry.modelcontextprotocol.io).
+
+```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

mcp_server_agentpay-0.1.0/pyproject.toml

@@ -0,0 +1,81 @@
+[project]
+name = "mcp-server-agentpay"
+version = "0.1.0"
+description = "MCP server for x402 micropayments — query paid APIs with autonomous USDC payments on Base"
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "yyx", email = "yunxuan517@gmail.com" }]
+keywords = ["mcp", "x402", "micropayments", "agents", "usdc", "base", "model-context-protocol"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+]
+
+dependencies = [
+    "mcp>=1.0.0",
+    "httpx>=0.28.0",
+    "pydantic>=2.10.0",
+    "pydantic-settings>=2.6.0",
+    "python-dotenv>=1.0.0",
+    "eth-account>=0.13.0",
+]
+
+[project.optional-dependencies]
+wallet = [
+    "web3>=7.0.0",
+]
+gateway = [
+    "fastapi>=0.115.0",
+    "uvicorn[standard]>=0.32.0",
+    "mcp-server-agentpay[wallet]",
+    "mcp-server-agentpay[x402]",
+]
+x402 = [
+    "x402[fastapi,httpx,evm]>=2.0.0",
+]
+dev = [
+    "pytest>=8.0.0",
+    "pytest-asyncio>=0.24.0",
+    "ruff>=0.8.0",
+    "mcp-server-agentpay[gateway,wallet,x402]",
+]
+
+[project.urls]
+Homepage = "https://github.com/yyxqqq777/mcp-server-agentpay"
+Repository = "https://github.com/yyxqqq777/mcp-server-agentpay"
+Documentation = "https://github.com/yyxqqq777/mcp-server-agentpay#readme"
+Issues = "https://github.com/yyxqqq777/mcp-server-agentpay/issues"
+
+[project.scripts]
+mcp-server-agentpay = "agentpay.mcp_server.server:main"
+agentpay-gateway = "agentpay.gateway.app:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/agentpay"]
+
+[tool.hatch.build.targets.sdist]
+include = [
+    "/src",
+    "/README.md",
+    "/LICENSE",
+    "/server.json",
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+testpaths = ["tests"]
+
+[tool.ruff]
+line-length = 100
+target-version = "py310"

mcp_server_agentpay-0.1.0/server.json

@@ -0,0 +1,63 @@
+{
+  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
+  "name": "io.github.yyxqqq777/agentpay",
+  "title": "AgentPay",
+  "description": "x402 micropayments MCP: Xiaohongshu notes and paid APIs settled in USDC on Base.",
+  "websiteUrl": "https://github.com/yyxqqq777/mcp-server-agentpay",
+  "repository": {
+    "url": "https://github.com/yyxqqq777/mcp-server-agentpay",
+    "source": "github",
+    "id": "1357808114"
+  },
+  "version": "0.1.0",
+  "remotes": [
+    {
+      "type": "streamable-http",
+      "url": "https://agentpay-xhs-production.up.railway.app/mcp"
+    }
+  ],
+  "packages": [
+    {
+      "registryType": "pypi",
+      "identifier": "mcp-server-agentpay",
+      "version": "0.1.0",
+      "transport": {
+        "type": "stdio"
+      },
+      "runtimeHint": "uvx",
+      "environmentVariables": [
+        {
+          "name": "GATEWAY_BASE_URL",
+          "description": "URL of the x402 payment gateway (e.g. https://agentpay-xhs-production.up.railway.app)",
+          "isRequired": true,
+          "format": "string",
+          "isSecret": false,
+          "default": "https://agentpay-xhs-production.up.railway.app"
+        },
+        {
+          "name": "AGENT_PRIVATE_KEY",
+          "description": "EVM private key for signing USDC micropayments on Base",
+          "isRequired": false,
+          "format": "string",
+          "isSecret": true
+        },
+        {
+          "name": "MAX_SPEND_PER_CALL",
+          "description": "Maximum USDC the agent may spend per API call (default: 0.10)",
+          "isRequired": false,
+          "format": "string",
+          "isSecret": false,
+          "default": "0.10"
+        },
+        {
+          "name": "PAYMENT_MODE",
+          "description": "Payment verification mode: demo (no on-chain) or production",
+          "isRequired": false,
+          "format": "string",
+          "isSecret": false,
+          "default": "production"
+        }
+      ]
+    }
+  ]
+}

mcp_server_agentpay-0.1.0/src/agentpay/__init__.py

@@ -0,0 +1,3 @@
+"""AgentPay — Agent-to-Agent micropayments via x402 + MCP."""
+
+__version__ = "0.1.0"