x402 Wallet
Self-custodial x402 wallet for AI agents: pay any service in USDC or $THREE from your…
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.2.3
- Listing updated
- 5 days ago
About x402 Wallet
x402 Wallet is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.
Self-custodial x402 wallet for AI agents: pay any service in USDC or $THREE from your own key.
Install
Run in a terminal
claude mcp add x402-mcp --env SOLANA_SECRET_KEY='<SOLANA_SECRET_KEY>' -- npx -y @three-ws/x402-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"x402-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/x402-mcp"
],
"env": {
"SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"x402-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/x402-mcp"
],
"env": {
"SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"x402-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/x402-mcp"
],
"env": {
"SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"x402-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/x402-mcp"
],
"env": {
"SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"x402-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/x402-mcp"
],
"env": {
"SOLANA_SECRET_KEY": "<SOLANA_SECRET_KEY>"
}
}
}
}Configuration
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.SOLANA_RPC_URLSolana mainnet RPC endpoint. Defaults to the public cluster — bring your own (Helius / Quicknode / Triton) for production traffic.MAX_PAY_USDMax USD a single pay_and_call may spend. Bounds a runaway or injected payment.REQUIRE_CONFIRMWhen on (default), pay_and_call refuses until re-issued with confirm:true. Set 0/false to disable the gate.THREE_WS_BASEBase URL of the three.ws API that serves /api/bazaar/search for find_services. Override only when self-hosting.
Pricing
Open source
Prices change. Check three.ws before you buy.
x402 Wallet FAQ
Is x402 Wallet free?
Yes. x402 Wallet is open source, so you can use and self-host it for free.
How do I add x402 Wallet to Claude Code?
Run this command in your terminal: claude mcp add x402-mcp --env SOLANA_SECRET_KEY='<SOLANA_SECRET_KEY>' -- npx -y @three-ws/x402-mcp
What are the best alternatives to x402 Wallet?
The closest alternatives to x402 Wallet are Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Budget Tracker, Quantivex Research and Provyan.
Alternatives to x402 Wallet

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments

Quantivex Research
MCP serverStock scores, what a price assumes, earnings quality and quiet profit revisions
- 11 tools
- Remote
- Free
- Finance and payments

Provyan
MCP serverBacktested crypto signal results on 94 coins, with luck odds and sources
- 7 tools
- Remote
- Free
- Finance and payments
TribuJus
MCP serverRead-only access to UK bank accounts, cards and transactions via TrueLayer Open Banking
Not checked yet- 5 tools
- Remote
- Open source
- Legal and government