PluginBench
MCP Server

x402 Wallet MCP Server

io.github.nirholas/x402-mcp

RepositoryRegistry

What is the x402 Wallet MCP server?

Self-custodial x402 wallet for AI agents: discover, inspect, and pay any x402 service in USDC.

How to install x402 Wallet

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • SOLANA_SECRET_KEY
    secret

    Base58 (or JSON byte-array) Solana secret key that signs payments and holds the USDC. Not needed for the read tools (find_services, inspect_endpoint, or x402_wallet with an explicit address). Treat like cash.

  • SOLANA_RPC_URL

    Solana mainnet RPC endpoint. Defaults to the public cluster — bring your own (Helius / QuickNode / Triton) for production traffic.

  • MAX_PAY_USD

    Max USD a single pay_and_call may spend. Bounds a runaway or injected payment.

  • REQUIRE_CONFIRM

    When on (default), pay_and_call refuses until re-issued with confirm:true. Set 0/false to disable the gate.

  • THREE_WS_BASE

    Base URL of the three.ws API that serves /api/bazaar/search for find_services. Override only when self-hosting.

Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/x402-mcp"
      ],
      "env": {
        "SOLANA_SECRET_KEY": "<YOUR_SOLANA_SECRET_KEY>",
        "SOLANA_RPC_URL": "<YOUR_SOLANA_RPC_URL>",
        "MAX_PAY_USD": "<YOUR_MAX_PAY_USD>",
        "REQUIRE_CONFIRM": "<YOUR_REQUIRE_CONFIRM>",
        "THREE_WS_BASE": "<YOUR_THREE_WS_BASE>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.json
{
  "mcpServers": {
    "x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/x402-mcp"
      ],
      "env": {
        "SOLANA_SECRET_KEY": "<YOUR_SOLANA_SECRET_KEY>",
        "SOLANA_RPC_URL": "<YOUR_SOLANA_RPC_URL>",
        "MAX_PAY_USD": "<YOUR_MAX_PAY_USD>",
        "REQUIRE_CONFIRM": "<YOUR_REQUIRE_CONFIRM>",
        "THREE_WS_BASE": "<YOUR_THREE_WS_BASE>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "x402-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/x402-mcp"
      ],
      "env": {
        "SOLANA_SECRET_KEY": "<YOUR_SOLANA_SECRET_KEY>",
        "SOLANA_RPC_URL": "<YOUR_SOLANA_RPC_URL>",
        "MAX_PAY_USD": "<YOUR_MAX_PAY_USD>",
        "REQUIRE_CONFIRM": "<YOUR_REQUIRE_CONFIRM>",
        "THREE_WS_BASE": "<YOUR_THREE_WS_BASE>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "x402-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/x402-mcp"
      ],
      "env": {
        "SOLANA_SECRET_KEY": "<YOUR_SOLANA_SECRET_KEY>",
        "SOLANA_RPC_URL": "<YOUR_SOLANA_RPC_URL>",
        "MAX_PAY_USD": "<YOUR_MAX_PAY_USD>",
        "REQUIRE_CONFIRM": "<YOUR_REQUIRE_CONFIRM>",
        "THREE_WS_BASE": "<YOUR_THREE_WS_BASE>"
      }
    }
  }
}
Claude Code
claude mcp add x402-mcp --env SOLANA_SECRET_KEY=<YOUR_SOLANA_SECRET_KEY> --env SOLANA_RPC_URL=<YOUR_SOLANA_RPC_URL> --env MAX_PAY_USD=<YOUR_MAX_PAY_USD> --env REQUIRE_CONFIRM=<YOUR_REQUIRE_CONFIRM> --env THREE_WS_BASE=<YOUR_THREE_WS_BASE> -- npx -y @three-ws/x402-mcp

Related MCP servers

3D AI Agent Avatar

3D AI Agent Avatar — render any GLB, give it a Solana wallet, a voice, and pump.fun powers.

View repository →

three.ws 3D Agent Tools

MCP tools from three.ws: free + paid text-to-3D, rigging, agent reputation, market intel.

View repository →

UCAI

UCAI — The ABI-to-MCP Server Generator. Convert any smart contract ABI into an AI-ready MCP server.

View repository →

three.ws Activity

Trending agents and coins, the $THREE holder leaderboard, and the site-wide activity ticker.

View repository →

three.ws AgenC

Browse the AgenC on-chain task marketplace, query the agent registry, and link identities.

View repository →

Agent Sniper

Self-custodial pump.fun sniper: arm strategies, snipe, manage positions. Simulate by default.

View repository →