Back to Directory/Developer Tools

io.github.kten-agent/x402-mcp-server

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

Developer ToolsTypeScriptv1.0.2

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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y hermes-asia-x402-mcp-server

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

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

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

hermes-asia-x402-mcp-servernpm

Compatible MCP Clients

io.github.kten-agent/x402-mcp-server works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More