Skip to content
appsgit

x402 Wallet

x402 Wallet is an MCP server that adds finance tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Self-custodial x402 wallet for AI agents: pay any service in USDC or $THREE from your own key. It has 250 GitHub stars, is released under the Apache-2.0 license and runs locally with npx -y @three-ws/x402-mcp.

github.com/nirholas/three.ws (opens in a new tab)

Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error

View on GitHub (opens in a new tab)Website (opens in a new tab)

Install x402 Wallet

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "x402-wallet": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/x402-mcp"
      ],
      "env": {
        "SOLANA_SECRET_KEY": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env SOLANA_SECRET_KEY=your-value --transport stdio x402-wallet -- npx -y @three-ws/x402-mcp

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "x402-wallet": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/x402-mcp"
      ],
      "env": {
        "SOLANA_SECRET_KEY": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "solana_secret_key",
      "description": "SOLANA_SECRET_KEY",
      "password": true
    }
  ],
  "servers": {
    "x402-wallet": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/x402-mcp"
      ],
      "env": {
        "SOLANA_SECRET_KEY": "${input:solana_secret_key}"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
SOLANA_SECRET_KEYsecretNoBase58 (or JSON byte-array) Solana secret key that signs payments and holds the USDC. Not needed for the read tools (findservices, inspectendpoint, or…
SOLANA_RPC_URLNoSolana mainnet RPC endpoint. Defaults to the public cluster — bring your own (Helius / Quicknode / Triton) for production traffic.
MAX_PAY_USDNoMax USD a single payandcall may spend. Bounds a runaway or injected payment.
REQUIRE_CONFIRMNoWhen on (default), payandcall refuses until re-issued with confirm:true. Set 0/false to disable the gate.
THREE_WS_BASENoBase URL of the three.ws API that serves /api/bazaar/search for find_services. Override only when self-hosting.

Tools (22)

Parsed from the Tools section of the README; check the repository for the current list.

  • x402_wallet

    read-only

  • find_services

    read-only

  • inspect_endpoint

    read-only

  • pay_and_call

    execution

  • spending_report

    read-only

  • weather_forecast

    $0.001

  • weather_go_no_go

    $0.002

  • carbon_now

    $0.001

  • carbon_best_window

    $0.002

  • domain_rdap_check

    $0.001

  • domain_rdap_check_bulk

    $0.005

  • research_search

    $0.002

  • research_paper

    $0.003

  • research_bibliography

    $0.005

  • book_search

    $0.001

  • book_read

    $0.01

  • news_wire_search

    $0.003

  • news_wire_poll

    $0.002

  • transit_plan

    $0.002

  • transit_delays

    $0.001

  • places_search

    $0.002

  • places_detail

    $0.002

About x402 Wallet

Give any AI agent a self-custodial x402 wallet — discover, inspect, and pay any paid service in USDC from your own Solana key.

  • animation
  • avatar
  • gltf
  • llm
  • mcp
  • webgl
  • 3d-generation
  • ai-agents
  • digital-human
  • generative-ai

Similar MCP servers

More finance MCP servers

All Finance

FAQ

x402 Wallet FAQ

Still curious? Email info@appsgit.com.

How do I install the x402 Wallet MCP server?

Add the command npx -y @three-ws/x402-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is x402 Wallet free?

The server is open source under the Apache-2.0 license, so running it is free. It needs credentials (SOLANA_SECRET_KEY) for the service it connects to, which may require a paid account.

Is x402 Wallet actively maintained?

The most recent commit was on Oct 25, 2026. The latest release is forge-v0.5.0, published Oct 11, 2026. appsgit only lists MCP servers with a commit in the last six months.