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 282 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
Install x402 Wallet
Generated from the server's MCP registry entry. Replace your-value with your own values.
Claude Desktop
{
"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-mcpCursor
{
"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
{
"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.
| Name | Required | Description |
|---|---|---|
SOLANA_SECRET_KEYsecret | No | Base58 (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_URL | No | Solana mainnet RPC endpoint. Defaults to the public cluster — bring your own (Helius / Quicknode / Triton) for production traffic. |
MAX_PAY_USD | No | Max USD a single payandcall may spend. Bounds a runaway or injected payment. |
REQUIRE_CONFIRM | No | When on (default), payandcall refuses until re-issued with confirm:true. Set 0/false to disable the gate. |
THREE_WS_BASE | No | Base 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_walletread-only
find_servicesread-only
inspect_endpointread-only
pay_and_callexecution
spending_reportread-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.
- avatar
- ai-agents
- mcp-server
- solana
- text-to-3d
- threejs
- x402
- claude-code-plugin
Similar MCP servers
More finance MCP servers
Alchemy MCP Server
alchemyplatform/alchemy-mcp-server
Blockchain data across 100+ chains: token prices, NFTs, transfers, simulation, traces, Solana DAS.
Maintained · last commit Sep 24, 2026
OfficialFinanceMonarch Money
pulsemcp/mcp-servers
MCP server for Monarch Money — account, transaction, and budget management.
Maintained · last commit Aug 30, 2026
OfficialFinanceTypeScriptU.S. Government Open Data
lzinga/us-gov-open-data-mcp
Open data from 40+ U.S. government APIs: economy, spending, Congress, health, energy, disasters.
Active · last commit Oct 26, 2026
FinanceTypeScriptNorman Finance — AI Bookkeeping, Accounting & Taxes
norman-finance/norman-mcp-server
Bookkeeping, invoices and tax workflows for European businesses, including Polish KPiR and JPK.
Active · last commit Nov 15, 2026
OfficialFinanceLuxAlgo MCP
LuxAlgo/luxalgo-mcp-server
LuxAlgo for AI agents: the Library, prop firms, Market Trackers, Edge Stats, and your Trade Journal.
Active · last commit Nov 7, 2026
FinanceTypeScriptTrade It
trade-it-inc/trade-it-mcp
Connect brokerage accounts to AI assistants: holdings, orders, asset lookup, and approved trading.
Maintained · last commit Oct 15, 2026
OfficialFinance
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 Nov 15, 2026. The latest release is v2026.11.09, published Nov 9, 2026. appsgit only lists MCP servers with a commit in the last six months.