x402 Wallet

local MCP server

Installation

Terminal

claude mcp add io-github-nirholas-x402-mcp -e SOLANA_SECRET_KEY=... -e SOLANA_RPC_URL=... -e MAX_PAY_USD=... -e REQUIRE_CONFIRM=... -e THREE_WS_BASE=... -- npx -y @three-ws/x402-mcp

Run in your project folder. Add --scope user to use it everywhere.

Claude Desktop, Cursor & other clients

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "io-github-nirholas-x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/x402-mcp"
      ],
      "env": {
        "SOLANA_SECRET_KEY": "...",
        "SOLANA_RPC_URL": "...",
        "MAX_PAY_USD": "...",
        "REQUIRE_CONFIRM": "...",
        "THREE_WS_BASE": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

Summary

Self-custodial x402 wallet for AI agents: pay any service in USDC or $THREE from your own key.

Questions

x402 Wallet is a local MCP server distributed as the npm package @three-ws/x402-mcp.

Run: claude mcp add io-github-nirholas-x402-mcp -e SOLANA_SECRET_KEY=... -e SOLANA_RPC_URL=... -e MAX_PAY_USD=... -e REQUIRE_CONFIRM=... -e THREE_WS_BASE=... -- npx -y @three-ws/x402-mcp

Run: codex mcp add io-github-nirholas-x402-mcp --env SOLANA_SECRET_KEY=... --env SOLANA_RPC_URL=... --env MAX_PAY_USD=... --env REQUIRE_CONFIRM=... --env THREE_WS_BASE=... -- npx -y @three-ws/x402-mcp

Similar MCP servers

NameStars

rustunnelio.github.joaoh82/rustunnel656
three.ws Activityio.github.nirholas/activity-mcp218
Metaplex Agent Registryio.github.nirholas/metaplex-agent218
three.ws Visionio.github.nirholas/vision-mcp218
mcpio.github.seldonframe/mcp51
janeeio.github.rsdouglas/janee30
engramio.github.kael-bit/engram27
cacheoverflowio.github.GetCacheOverflow/cacheoverflow19