x402 Wallet
local MCP serverx402 Wallet is a local MCP server: Self-custodial x402 wallet for AI agents: pay any service in USDC or $THREE from your own key. Install it from npm as @three-ws/x402-mcp.
Installation
Terminal
claude mcp add io-github-nirholas-x402-mcp -e SOLANA_SECRET_KEY=... -e SOLANA_RPC_URL=... -e MAX_PAY_USD=... -e REQUIRE_CONFIRM=... -e THREE_WS_BASE=... -- npx -y @three-ws/x402-mcp
Run in your project folder. Add --scope user to use it everywhere.
Claude Desktop, Cursor & other clients
Add to claude_desktop_config.json or .cursor/mcp.json.
{
"mcpServers": {
"io-github-nirholas-x402-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/x402-mcp"
],
"env": {
"SOLANA_SECRET_KEY": "...",
"SOLANA_RPC_URL": "...",
"MAX_PAY_USD": "...",
"REQUIRE_CONFIRM": "...",
"THREE_WS_BASE": "..."
}
}
}
}Fill in the environment variables with your own credentials.
What you need
- Runtime: Node.js 18+ (runs with npx).
- MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
- Environment variables:
SOLANA_SECRET_KEY,SOLANA_RPC_URL,MAX_PAY_USD,REQUIRE_CONFIRM,THREE_WS_BASE
Summary
Self-custodial x402 wallet for AI agents: pay any service in USDC or $THREE from your own key.
x402 Wallet vs similar servers
| Server | Stars | Type | API key | Runtime |
|---|---|---|---|---|
| x402 Wallet | 218 | Local | Yes | npm |
| rustunnel | 656 | Local | No | mcpb |
| three.ws Activity | 218 | Local | Yes | npm |
| Metaplex Agent Registry | 218 | Local | Yes | npm |
| three.ws Vision | 218 | Local | Yes | npm |
Questions
It reads 5 environment variables: SOLANA_SECRET_KEY, SOLANA_RPC_URL, MAX_PAY_USD, REQUIRE_CONFIRM, THREE_WS_BASE. Set them in your MCP config before starting the server.
Node.js 18+ (runs with npx), plus an MCP client such as Claude Code, Codex, Claude Desktop or Cursor.
x402 Wallet is a local MCP server distributed as the npm package @three-ws/x402-mcp.
Run: claude mcp add io-github-nirholas-x402-mcp -e SOLANA_SECRET_KEY=... -e SOLANA_RPC_URL=... -e MAX_PAY_USD=... -e REQUIRE_CONFIRM=... -e THREE_WS_BASE=... -- npx -y @three-ws/x402-mcp
Run: codex mcp add io-github-nirholas-x402-mcp --env SOLANA_SECRET_KEY=... --env SOLANA_RPC_URL=... --env MAX_PAY_USD=... --env REQUIRE_CONFIRM=... --env THREE_WS_BASE=... -- npx -y @three-ws/x402-mcp
Similar MCP servers
NameStars
- rustunnelio.github.joaoh82/rustunnel656
- three.ws Activityio.github.nirholas/activity-mcp218
- Metaplex Agent Registryio.github.nirholas/metaplex-agent218
- three.ws Visionio.github.nirholas/vision-mcp218
- tldrawio.github.tldraw/tldraw51K
- Codebase Memoryio.github.DeusData/codebase-memory-mcp45K
- Repomixio.github.yamadashy/repomix29K
- dbxio.github.t8y2/dbx21K