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 41 MCP servers published from nirholas/three.ws. Stars and repository activity are shared across all of them. See all 41 →
VERIFIED ACTIVE
LAST COMMIT 2026-09-30 · VERIFIED 2026-09-30
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.5.2 · 2026-09-30
Everything three.ws shipped from 2026-08-29 to 2026-09-30, taken from the public changelog. 175 user-facing changes. · Try it at three.ws, read the docs, follow the full changelog (RSS), or connect your assistant to…
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 71 MCP servers from nirholas - 70 actively maintained, 7,910 combined GitHub stars, oldest repo from Feb 2024. Full record: all servers from nirholas.
- Alibaba Cloud DashScope - Qwen Alibaba Cloud DashScope MCP: Qwen chat, embeddings, and model discovery on your own account. ★ 219
- three.ws Vision Image understanding for AI agents - analyze and describe any image via the three.ws pipeline. ★ 219
- three.ws Copy Trading Manage copy-trade follows - follow leaders, tune sizing and guard rules, and track fees owed. ★ 219
- pump.fun Solana Data Free, read-only pump.fun + Solana MCP: token discovery, on-chain analysis, SNS, 3D snapshots. ★ 219
- three.ws Avatars three.ws 3D avatars in your agent: render a live, interactive 3D avatar inline, or get an embed. ★ 219
- $THREE Token Price, hold, and burn $THREE on Solana - the first MCP server whose actions burn a token. ★ 219
05 · Facts
- repository
- github.com/nirholas/three.ws
- website
- https://three.ws/
- category
- AI & ML - actively maintained as of 2026-09-30.
- 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-30, its last commit was 2026-09-30. 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,555 · 2026-09-30
- Wigolo Local-first web intelligence MCP server for AI coding agents ★ 5,432 · 2026-09-29
- Auto TS Automated time series forecasting with model search, anomaly detection, and event risk analysis ★ 1,429 · 2026-08-25
- Anymd Any file → clean Markdown for AI agents: PDF, Office, EPUB, HTML, images, audio/video. Local MCP. ★ 963 · 2026-09-29
- Haiku RAG Local-first agentic RAG with citations - hybrid search, reranking, multimodal document retrieval ★ 615 · 2026-09-30
- Local RAG (shinpr) Easy-to-setup local RAG server with minimal configuration ★ 405 · 2026-09-29
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 · Plan Exe · Ncp · Prompt Branch
More JavaScript MCP servers · Nitrosend · Projectmind · Getregdata · Deploy · Proxy4agents MCP · see all