X402 Wallet MCP Server

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

Local serverstdio

What is the X402 Wallet MCP Server?

X402 Wallet is an MCP integration. Self-custodial x402 wallet for AI agents: pay any service in USDC or $THREE from your own key.

Packages and local setup

The published npm package is @three-ws/x402-mcp, version 0.2.2. Its declared MCP transport is stdio.

The package declares SOLANA_SECRET_KEY: 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..

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository · Project website. This profile uses version 0.2.2 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related other integrations MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
SOLANA_SECRET_KEYBase58 (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.Optional
SOLANA_RPC_URLSolana mainnet RPC endpoint. Defaults to the public cluster — bring your own (Helius / Quicknode / Triton) for production traffic.Optional
MAX_PAY_USDMax USD a single pay_and_call may spend. Bounds a runaway or injected payment.Optional
REQUIRE_CONFIRMWhen on (default), pay_and_call refuses until re-issued with confirm:true. Set 0/false to disable the gate.Optional
THREE_WS_BASEBase URL of the three.ws API that serves /api/bazaar/search for find_services. Override only when self-hosting.Optional