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 分

    請在儲存庫或註冊中心條目中宣告授權條款。