x402 Wallet MCP Server
Give any AI agent a self-custodial x402 wallet - discover, inspect, and pay any paid service in USDC from your own Solana key.
People who work with Solana and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.
One of 37 MCP servers published from nirholas/three.ws. Stars and repository activity are shared across all of them. See all 37 →
VERIFIED ACTIVE
LAST COMMIT 2026-09-18 · VERIFIED 2026-09-18
Apache-2.0 · JavaScript servers · how we verify → /methodology
01 · Install x402 Wallet
before you install - you'll need
Set SOLANA_RPC_URL before connecting. SOLANA_SECRET_KEY, MAX_PAY_USD are optional or environment-specific per the README.
Claude Code
claude mcp add nirholas-three.ws-packages-x402-mcp -- npx -y @three-ws/x402-mcpClaude Desktop / Cursor / VS Code - add to config
{
"mcpServers": {
"nirholas-three.ws-packages-x402-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/x402-mcp"
]
}
}
}Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.
Using another client? Same JSON, different key
Claude Desktop · mcpServers
Cursor · mcpServers
VS Code · servers
Windsurf · mcpServers
Zed · context_servers
Cline · mcpServers
Roo Code · mcpServers
Continue · mcpServers
LibreChat · mcpServers
Gemini CLI · mcpServers
Codex CLI · mcp_servers
Full setup guides: every client.
02 · Evidence
Security posture
What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.
runs as local process (stdio) - runs on your machine with your user's permissions
license Apache-2.0 - declared in the repository
npm package @three-ws/x402-mcp - the @three-ws scope differs from the repo owner (nirholas); confirm it's the project's official package
registry namespace io.github.nirholas is GitHub-verified and matches the repo owner
03 · What x402 Wallet can do
Prose above is summarized from the project's README and registry record - no invented capabilities.
Latest releases
v1.0.0 · 2026-08-28
!three.ws · three.ws is an Android app. Install it and the platform opens full-screen, with no browser chrome around it, and every signature is routed to the wallet on your phone. · Install · 1. Open…
04 · Who maintains x402 Wallet
x402 Wallet is maintained by nirholas. We track 66 MCP servers from nirholas - 65 actively maintained, 7,838 combined GitHub stars, oldest repo from Feb 2024. Full record: all servers from nirholas.
- Metaplex Agent Registry Deploy AI agents on-chain on Solana with an EIP-8004 identity. Deploy fee funds $THREE buybacks. ★ 194
- three.ws Copy Trading Manage copy-trade follows - follow leaders, tune sizing and guard rules, and track fees owed. ★ 194
- Alibaba Cloud DashScope - Qwen Alibaba Cloud DashScope MCP: Qwen chat, embeddings, and model discovery on your own account. ★ 194
- pump.fun Solana Data Free, read-only pump.fun + Solana MCP: token discovery, on-chain analysis, SNS, 3D snapshots. ★ 194
- three.ws Vanity Read the three.ws vanity-address market: quote difficulty + USDC price, browse the board. ★ 194
- three.ws Naming On-chain identity for AI agents: resolve .sol names, reverse-lookup wallets, check handles. ★ 194
05 · Facts
- repository
- github.com/nirholas/three.ws
- website
- https://three.ws/
- category
- AI & ML - actively maintained as of 2026-09-18.
- registry
- io.github.nirholas/x402-mcp (active, first published 2026-06-23 · 3 versions)
- packages
- npm:@three-ws/x402-mcp
06 · x402 Wallet FAQ
What is 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.
Is x402 Wallet still maintained?
Yes - as of 2026-09-18, its last commit was 2026-09-18. We re-verify nightly.
How do I install x402 Wallet?
Run `npx -y @three-ws/x402-mcp`. The README documents 3 environment variables (SOLANA_SECRET_KEY, SOLANA_RPC_URL, MAX_PAY_USD) to set first. Set SOLANA_RPC_URL before connecting. SOLANA_SECRET_KEY, MAX_PAY_USD are optional or environment-specific per the README. You can also paste the ready-made client config above.
Does x402 Wallet run locally?
Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.
07 · Alternatives to x402 Wallet
Alternatives to x402 Wallet
Maintained AI & ML servers if x402 Wallet isn't the fit.
- Fun ASR Transcribe local audio with FunASR and SenseVoice using private, on-device inference. ★ 20,411 · 2026-09-18
- Auto TS Automated time series forecasting with model search, anomaly detection, and event risk analysis ★ 1,428 · 2026-08-25
- Haiku RAG Local-first agentic RAG with citations - hybrid search, reranking, multimodal document retrieval ★ 609 · 2026-09-17
- Plan Exe MCP server for generating rough-draft project plans from natural-language prompts. ★ 401 · 2026-09-13
- Local RAG (shinpr) Easy-to-setup local RAG server with minimal configuration ★ 398 · 2026-09-18
- PageIndex MCP Reasoning-based RAG system for chatting with long PDFs. Supports local and online files. ★ 388 · 2026-07-25
Pairs well with
Servers that cover what x402 Wallet doesn't - only shown when the pairing reason fits the companion.
More AI & ML MCP servers · As A Judge · Pipes Hub · Ncp · Prompt Branch
More JavaScript MCP servers · Nitrosend · Projectmind · Getregdata · Deploy · Proxy4agents MCP · see all