Keyflow

Search Keyflow

Find a shortcut, workflow, MCP server or skill

x402 Wallet

local MCP server

x402 Wallet is a local MCP server: Self-custodial x402 wallet for AI agents: pay any service in USDC or $THREE from your own key. Install it from npm as @three-ws/x402-mcp.

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.

What you need

  • Runtime: Node.js 18+ (runs with npx).
  • MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
  • Environment variables: SOLANA_SECRET_KEY, SOLANA_RPC_URL, MAX_PAY_USD, REQUIRE_CONFIRM, THREE_WS_BASE

Summary

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

x402 Wallet vs similar servers

ServerStarsTypeAPI keyRuntime
x402 Wallet218LocalYesnpm
rustunnel656LocalNomcpb
three.ws Activity218LocalYesnpm
Metaplex Agent Registry218LocalYesnpm
three.ws Vision218LocalYesnpm

Questions

It reads 5 environment variables: SOLANA_SECRET_KEY, SOLANA_RPC_URL, MAX_PAY_USD, REQUIRE_CONFIRM, THREE_WS_BASE. Set them in your MCP config before starting the server.

Node.js 18+ (runs with npx), plus an MCP client such as Claude Code, Codex, Claude Desktop or Cursor.

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
  1. rustunnelio.github.joaoh82/rustunnel656
  2. three.ws Activityio.github.nirholas/activity-mcp218
  3. Metaplex Agent Registryio.github.nirholas/metaplex-agent218
  4. three.ws Visionio.github.nirholas/vision-mcp218
  5. tldrawio.github.tldraw/tldraw51K
  6. Codebase Memoryio.github.DeusData/codebase-memory-mcp45K
  7. Repomixio.github.yamadashy/repomix29K
  8. dbxio.github.t8y2/dbx21K