Back to Browse

X402 MCP Server

Developer ToolsUse Caution2.2MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

2.2
Use Caution2.2Critical Risk

This MCP server implements a cryptocurrency payment system (x402 protocol) for data access with generally sound architecture, but contains several security concerns that warrant user awareness. The private key handling is environment-variable based (good), but the server automatically signs and submits blockchain transactions on behalf of the user without explicit per-transaction confirmation, which creates financial risk. Additionally, the hardcoded Worker URL and recipient address reduce user control, and there are minor input validation gaps. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.

7 files analyzed · 15 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

process_spawn

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-kten-agent-x402-mcp-server": {
      "args": [
        "-y",
        "hermes-asia-x402-mcp-server"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub 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)

# 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

# Claude Code / any MCP client
claude mcp add hermes-asia -- npx hermes-asia-x402-mcp@latest

# Install globally
npm install -g hermes-asia-x402-mcp-server

Configuration

export X402_WALLET_PRIVATE_KEY="0x..."   # Wallet with USDC on Base
export 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

Reviews

No reviews yet

Be the first to review this server!

X402 MCP Server - MCP server for Hermes Asia x402 CN/JP market intelligence | MCP Marketplace