X402 Mcp Server

io.github.kten-agentPublished by GitHub account kten-agentv1.0.2Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyFinanceBusiness & Commerce

Overview

AI-generated overview

Local MCP server that lets an assistant buy Hermes Asia market-intelligence reports, paying per call in USDC on Base through the x402 protocol.

What you can do
Purchase Asia market-intelligence reports: China/Taiwan/Japan trade policy, Japanese research, anime industry, Tokyo night economy, China silver economy, lying-flat trend and China real estate 2026, each at a listed per-call price in USDC on Base, with no API keys or subscriptions.
When to use it
Use it when an assistant needs paid Asia-focused market or policy research and you are willing to pay per request in USDC on Base, with no API key or subscription setup.
Requirements
Node.js 20 or newer, run locally via npx or a global npm install. A wallet holding USDC on Base and a small amount of ETH on Base for gas. The X402_WALLET_PRIVATE_KEY and WORKER_URL environment variables must be set. Network access to the Hermes worker endpoint.
Before you install
The server needs X402_WALLET_PRIVATE_KEY, a wallet private key, and signs payment manifests with it; use a dedicated low-balance wallet. Every tool call spends real USDC on-chain, roughly $0.02 to $0.03 per report plus gas, automatically and without human confirmation. Requests and payment go to a third-party worker endpoint.

Installation

In SourceWeft

  1. Open X402 Mcp Server in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

Source: README.md at commit 1a23601

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.2LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.