io.github.xenarch-ai/xenarch-mcp

Official

by xenarch-ai · TypeScript

Xenarch — x402 MCP server for AI agent payments. Non-custodial, USDC on Base L2.

Non-custodial payment processor for AI agents using USDC on Base L2.

Topics

ai-agentsmcpmicropaymentsmodel-context-protocolx402agent-paymentsbase-blockchainusdc

Install

Configuration

Environment variables

XENARCH_PRIVATE_KEYsecret

Wallet private key (hex, 0x-prefixed). Auto-generates on first run if omitted.

XENARCH_RPC_URL

Base RPC endpoint URL

XENARCH_NETWORK

Network for payments (base or base-sepolia)

XENARCH_MAX_PAYMENT_USD

Local per-call payment cap in USDC (default 1.00). The only spending ceiling in standalone mode; set 0 to disable. Connect XENARCH_API_TOKEN for managed per-tx/daily/monthly caps.

PORT

Port for HTTP server (default: 3000)

TRANSPORTrequired

Set to 'http' to enable HTTP transport

claude_desktop_config.json

{
  "mcpServers": {
    "xenarch-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@xenarch/agent-mcp@1.1.0"
      ],
      "env": {
        "XENARCH_PRIVATE_KEY": "<YOUR_XENARCH_PRIVATE_KEY>",
        "XENARCH_RPC_URL": "<YOUR_XENARCH_RPC_URL>",
        "XENARCH_NETWORK": "<YOUR_XENARCH_NETWORK>",
        "XENARCH_MAX_PAYMENT_USD": "<YOUR_XENARCH_MAX_PAYMENT_USD>"
      }
    }
  }
}