English Français العربية

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

السجل الرسمي أخرى

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package hermes-asia-x402-mcp-server
Claude Code 
claude mcp add x402-mcp-server -- npx -y hermes-asia-x402-mcp-server@1.0.2
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "x402-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "hermes-asia-x402-mcp-server@1.0.2"
            ]
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Hermes Asia x402 MCP Server
  2. Quick Demo（AI Agent Purchase Flow）
  3. Buy Now（Direct x402 Payment）
  4. Installation
  5. Configuration
  6. Payment Flow
  7. Worker Endpoints
  8. Requirements
  9. Repository
  10. License

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

الأسئلة الشائعة

ما هو io.github.kten-agent/x402-mcp-server؟

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

كيف أثبّت io.github.kten-agent/x402-mcp-server؟

يعمل على جهازك. في Claude Code: claude mcp add x402-mcp-server -- npx -y hermes-asia-x402-mcp-server@1.0.2. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.kten-agent/x402-mcp-server إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل io.github.kten-agent/x402-mcp-server مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.kten-agent/x402-mcp-server؟

ينشره kten-agent. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.