X402 Mcp Server

io.github.kten-agent由 GitHub 账号 kten-agent 发布v1.0.2更新于 Oct 24, 2026

MCP server for Hermes Asia x402 CN/JP market intelligence via USDC on Base. 8 endpoints.

已验证STDIO仅桌面金融商业与电商

概览

AI 生成的概览

本地 MCP 服务器，让助手按次以 Base 链上的 USDC 通过 x402 协议购买 Hermes Asia 市场情报报告。

可以做什么
购买亚洲市场情报报告：中国/台湾/日本贸易政策、日本研究、动漫产业、东京夜经济、中国银发经济、躺平现象以及 2026 年中国房地产，每项按标价以 Base 链上的 USDC 按次付费，无需 API 密钥或订阅。
适用场景
当助手需要付费的亚洲市场或政策研究，且你愿意按请求以 Base 链上的 USDC 付费、不打算配置 API 密钥或订阅时使用。
运行要求
Node.js 20 或更高版本，通过 npx 或全局 npm 安装后在本地运行。需要一个持有 Base 链 USDC 的钱包，以及少量 Base 链 ETH 用于 gas。必须设置 X402_WALLET_PRIVATE_KEY 和 WORKER_URL 环境变量。需要能访问 Hermes worker 端点的网络。
安装前请注意
服务器需要 X402_WALLET_PRIVATE_KEY（钱包私钥）并用它签署支付清单，请使用专用的低余额钱包。每次工具调用都会自动在链上花费真实 USDC，每份报告约 0.02 至 0.03 美元外加 gas，且无需人工确认。请求和付款会发送到第三方 worker 端点。

安装

在 SourceWeft 中

  1. 打开 控制台中的 X402 Mcp Server，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

Hermes Asia x402 MCP Server

AI agents pay USDC directly for Asia market intelligence — no API keys, no subscriptions.

Quick Demo（AI Agent Purchase Flow）

bash
# Any MCP-compatible AI agent can buy data like this:npx hermes-asia-x402-mcp@latest
# Agent calls a tool → gets HTTP 402 with payment manifest# → Signs manifest with wallet → pays USDC on-chain → receives data# All automatic. No human in the loop.

Buy Now（Direct x402 Payment）

ProductPriceEndpoint
Asia Intelligence（CN/TW/JP trade policy）$0.02POST /api/asia-intelligence
Japanese Research（Nikkei + BOJ policy）$0.02POST /api/japanese-research
Bilingual Bridge（CN-JP patent translation）$0.03POST /api/bilingual-bridge
Anime Industry Intel$0.02POST /api/anime-industry-intel
Kabukicho Business Guide（Tokyo night economy）$0.02POST /api/kabukicho-guide
China Silver Economy（297M seniors market）$0.02POST /api/china-silver-economy
Lying Flat Report（China social trend）$0.02POST /api/lying-flat-report
China Real Estate 2026$0.03POST /api/china-real-estate-2026

Payment: USDC on Base（eip155:8453） Recipient: 0xFC80725F8Fd574c030F0379Fb4F86ddCE557Db7D Protocol: x402 v2, scheme=exact No API keys required.

Installation

bash
# Claude Code / any MCP clientclaude mcp add hermes-asia -- npx hermes-asia-x402-mcp@latest
# Install globallynpm install -g hermes-asia-x402-mcp-server

Configuration

bash
export X402_WALLET_PRIVATE_KEY="0x..."   # Wallet with USDC on Baseexport WORKER_URL="https://base-worker-01.j23726919.workers.dev"

Payment Flow

  1. AI agent calls an MCP tool（e.g. asia_intelligence）
  2. MCP Server POSTs to Hermes Worker → receives HTTP 402
  3. MCP Server parses WWW-Authenticate header（x402 v2 manifest）
  4. MCP Server signs manifest with wallet private key（EIP-191）
  5. MCP Server retries with Authorization header
  6. Worker returns data; USDC transferred on-chain atomically

No API keys. No subscriptions. Pay per call.

Worker Endpoints

EndpointPriceDescription
POST /api/asia-intelligence$0.02China/Taiwan/Japan trade policy intelligence
POST /api/japanese-research$0.02Nikkei news + BOJ monetary policy
POST /api/bilingual-bridge$0.03CN-JP patent & technical document translation
POST /api/anime-industry-intel$0.02Japan anime industry investment analysis
POST /api/kabukicho-guide$0.02Tokyo night economy business opportunities
POST /api/china-silver-economy$0.02China 297M seniors market deep dive
POST /api/lying-flat-report$0.02China's lying-flat phenomenon analysis
POST /api/china-real-estate-2026$0.03China property market outlook 2026

Requirements

  • Node.js >= 20.0.0
  • Wallet with USDC on Base chain
  • ETH on Base chain（for gas, ~$0.01 per transaction）

Repository

GitHub: kten-agent/x402-mcp-server npm: hermes-asia-x402-mcp-server MCP Registry: io.github.kten-agent/x402-mcp-server

License

MIT

来源：README.md，提交 1a23601

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.2最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。