mcpField
X
x402-mcp-server

x402-mcp-server

Local
github.com/kten-agentBusiness & Marketing0Updated 22w ago
Repository

About x402-mcp-server

x402-mcp-server provides eight paid Asia market-intelligence tools for AI agents, covering trade policy, Japanese research, translation and industry reports. It handles x402 payments in USDC on Base per request, without API keys or subscriptions.

Key features

  1. 01Eight Asia intelligence endpoints
  2. 02Trade policy and Japanese research
  3. 03CN-JP patent translation
  4. 04Anime and Tokyo business reports
  5. 05China market and social trend reports
  6. 06USDC payment on Base per call

Use cases

  1. 01Retrieve CN/TW/JP trade policy intelligence
  2. 02Research Nikkei news and BOJ policy
  3. 03Translate CN-JP patent documents
  4. 04Review anime, Tokyo or China market trends

MCP support

Exposes eight tools to MCP-compatible agents. The server obtains data by completing x402 USDC payments on Base when a tool is called.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "kten-agent-x402": {
      "command": "npx",
      "args": [
        "-y",
        "hermes-asia-x402-mcp-server"
      ]
    }
  }
}
Run commandnpx -y hermes-asia-x402-mcp-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmhermes-asia-x402-mcp-server1.0.2

Tools

11

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
daysnumberNoTime window in days
focusstringNoResearch focus area
querystringYesSearch query for Asian news
regionstringNoTarget region code (e.g., "CN", "JP", "TW")
numResultsnumberNoNumber of results (max 10)

Details

From the project 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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.