AI Plugin Index
x402 Wallet
CommunityMCP server by nirholas · updated · ★ 241
Self-custodial x402 wallet for AI agents: pay any service in USDC or $THREE from your own key. x402 Wallet is a community project by nirholas, not verified by a company domain.
Last commit 3 days ago
Apache-2.0: permissive, fine for commercial use
Clear description, published package or server URL, 241 stars, original repository
Not checked yet. What we check
What you need
| Setting | Needed | What it is |
|---|---|---|
SOLANA_SECRET_KEYEnvironment variable, secret | Optional | Base58 (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_URLEnvironment variable | Optional | Solana mainnet RPC endpoint. Defaults to the public cluster — bring your own (Helius / Quicknode / Triton) for production traffic. Default: https://api.mainnet-beta.solana.com |
MAX_PAY_USDEnvironment variable | Optional | Max USD a single pay_and_call may spend. Bounds a runaway or injected payment. Default: 1 |
REQUIRE_CONFIRMEnvironment variable | Optional | When on (default), pay_and_call refuses until re-issued with confirm:true. Set 0/false to disable the gate. Default: true |
THREE_WS_BASEEnvironment variable | Optional | Base URL of the three.ws API that serves /api/bazaar/search for find_services. Override only when self-hosting. Default: https://three.ws |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Install x402 Wallet
Built from the published package, never by AIclaude mcp add x402-wallet -- npx -y @three-ws/x402-mcpRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"x402-wallet": {
"command": "npx",
"args": [
"-y",
"@three-ws/x402-mcp"
]
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"x402-wallet": {
"command": "npx",
"args": [
"-y",
"@three-ws/x402-mcp"
]
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"x402-wallet": {
"command": "npx",
"args": [
"-y",
"@three-ws/x402-mcp"
]
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add x402-wallet -- npx -y @three-ws/x402-mcp{
"mcpServers": {
"x402-wallet": {
"command": "npx",
"args": [
"-y",
"@three-ws/x402-mcp"
]
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add x402-wallet npx -y @three-ws/x402-mcpGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the x402-wallet block.
Alternatives to x402 Wallet
All alternatives →
MCP server integrating with Stripe - tools for customers, products, payments, and more.
Official CCXT MCP server - Market data and trading across 100+ exchanges and prediction markets
200+ transparent financial metrics calculated from raw statements, not third-party endpoints.
JS API for Yahoo Finance
x402 Payment Protocol
x402 Payment Protocol
x402 Wallet: common questions
How do I install x402 Wallet?
In Claude Code run claude mcp add x402-wallet -- npx -y @three-ws/x402-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is x402 Wallet the official server?
x402 Wallet is a community project by nirholas, not verified by a company domain.
Is x402 Wallet free?
The code is published under the Apache-2.0 licence. The service it connects to may have its own pricing.
Is x402 Wallet safe to use?
It scores 82 of 100. Grades: maintenance A, licence A, quality B. The security check has not run for it yet. Review the code before you install. How grades work.
What are alternatives to x402 Wallet?
Similar MCP servers: mcp, CCXT, Finance Toolkit, Yahoo Finance2.
Does x402 Wallet work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.