Search / io.github.nirholas/x402-mcp
x402 Wallet
L0· runs locallySelf-custodial x402 wallet for AI agents: pay any service in USDC or $THREE from your own key.
v0.2.3 · active · repository · website · descriptor JSON · versions
Search / io.github.nirholas/x402-mcp
L0· runs locallySelf-custodial x402 wallet for AI agents: pay any service in USDC or $THREE from your own key.
v0.2.3 · active · repository · website · descriptor JSON · versions
{
"mcpServers": {
"x402-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/[email protected]"
],
"env": {
"SOLANA_SECRET_KEY": "${SOLANA_SECRET_KEY}",
"SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com",
"MAX_PAY_USD": "1",
"REQUIRE_CONFIRM": "true",
"THREE_WS_BASE": "https://three.ws"
}
}
}
}claude mcp add x402-mcp -e "SOLANA_SECRET_KEY=${SOLANA_SECRET_KEY}" -e "SOLANA_RPC_URL=https://api.mainnet-beta.solana.com" -e "MAX_PAY_USD=1" -e "REQUIRE_CONFIRM=true" -e "THREE_WS_BASE=https://three.ws" -- npx -y @three-ws/[email protected][mcp_servers.x402-mcp]
command = "npx"
args = ["-y", "@three-ws/[email protected]"]
env = { "SOLANA_SECRET_KEY" = "${SOLANA_SECRET_KEY}", "SOLANA_RPC_URL" = "https://api.mainnet-beta.solana.com", "MAX_PAY_USD" = "1", "REQUIRE_CONFIRM" = "true", "THREE_WS_BASE" = "https://three.ws" }
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"x402-mcp": {
"type": "local",
"command": [
"npx",
"-y",
"@three-ws/[email protected]"
],
"enabled": true,
"environment": {
"SOLANA_SECRET_KEY": "{env:SOLANA_SECRET_KEY}",
"SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com",
"MAX_PAY_USD": "1",
"REQUIRE_CONFIRM": "true",
"THREE_WS_BASE": "https://three.ws"
}
}
}
}{
"mcpServers": {
"x402-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/[email protected]"
],
"env": {
"SOLANA_SECRET_KEY": "${SOLANA_SECRET_KEY}",
"SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com",
"MAX_PAY_USD": "1",
"REQUIRE_CONFIRM": "true",
"THREE_WS_BASE": "https://three.ws"
}
}
},
"deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=x402-mcp&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIkB0aHJlZS13cy94NDAyLW1jcEAwLjIuMyJdLCJlbnYiOnsiU09MQU5BX1NFQ1JFVF9LRVkiOiIke1NPTEFOQV9TRUNSRVRfS0VZfSIsIlNPTEFOQV9SUENfVVJMIjoiaHR0cHM6Ly9hcGkubWFpbm5ldC1iZXRhLnNvbGFuYS5jb20iLCJNQVhfUEFZX1VTRCI6IjEiLCJSRVFVSVJFX0NPTkZJUk0iOiJ0cnVlIiwiVEhSRUVfV1NfQkFTRSI6Imh0dHBzOi8vdGhyZWUud3MifX0%3D"
}{
"servers": {
"x402-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@three-ws/[email protected]"
],
"env": {
"SOLANA_SECRET_KEY": "${SOLANA_SECRET_KEY}",
"SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com",
"MAX_PAY_USD": "1",
"REQUIRE_CONFIRM": "true",
"THREE_WS_BASE": "https://three.ws"
}
}
}
}{
"mcpServers": {
"x402-mcp": {
"command": "npx",
"args": [
"-y",
"@three-ws/[email protected]"
],
"env": {
"SOLANA_SECRET_KEY": "${SOLANA_SECRET_KEY}",
"SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com",
"MAX_PAY_USD": "1",
"REQUIRE_CONFIRM": "true",
"THREE_WS_BASE": "https://three.ws"
}
}
}
}extensions:
"x402-mcp":
enabled: true
name: "x402-mcp"
type: stdio
cmd: "npx"
args:
- "-y"
- "@three-ws/[email protected]"
envs:
"SOLANA_SECRET_KEY": "${SOLANA_SECRET_KEY}"
"SOLANA_RPC_URL": "https://api.mainnet-beta.solana.com"
"MAX_PAY_USD": "1"
"REQUIRE_CONFIRM": "true"
"THREE_WS_BASE": "https://three.ws"
timeout: 300
Placeholders to fill from your own secret store: ${SOLANA_SECRET_KEY}. The registry never accepts secret values.
This is a local package: the command runs on your machine.
Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.
protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)auth.prm, auth.as_metadata, auth.cimdno remote uses OAuthauth.secret_in_urlno templated URLtools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)stability.changes, stability.rug_pulltool list unknowndeps.known_vulns5 advisories of lower severity or without a published fix: GHSA-3gc7-fjrx-p6mg in [email protected] (indirect, no fix yet), GHSA-528h-pc64-c93x in [email protected] (indirect, fixed in 3.5.0), GHSA-hqr4-qq8f-hg3x in [email protected] (indirect, fixed in 3.6.0), ...deps.mcp_sdk_version@modelcontextprotocol/sdk 1.32.1, no known advisorydeps.resolvable@three-ws/[email protected] resolved: 229 packagesNo tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.
Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.
+repository +namespace-matches-repo +website ~liveness-unmeasured +updated-9d-ago -duplicate-repo(51 names)
Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.
@three-ws/[email protected] npm228 dependencies, resolved · MCP SDK @modelcontextprotocol/sdk 1.32.1 · advisories checked 2026-10-19
| advisory | severity | package | fixed in |
|---|---|---|---|
| GHSA-3gc7-fjrx-p6mgbigint-buffer Vulnerable to Buffer Overflow via toBigIntLE() Function | high | [email protected]indirect | no fix yet |
| GHSA-528h-pc64-c93xstream-json: pick/ignore/filter/replace filters are O(depth²) on nested input — small crafted JSON blocks the event loop for seconds→minutes (DoS) | moderate | [email protected]indirect | fixed in 3.5.0 |
| GHSA-hqr4-qq8f-hg3xstream-json: JSONC parser and verifier re-scan the whole accumulated comment on every input chunk | moderate | [email protected]indirect | fixed in 3.6.0 |
| GHSA-mjw6-4jj6-33hcstream-json has a prototype pollution issue: Assembler writes this.current[this.key] on plain objects | moderate | [email protected]indirect | fixed in 3.6.0 |
| GHSA-w5hq-g745-h8pquuid: Missing buffer bounds check in v3/v5/v6 when buf is provided | moderate | [email protected]indirect | fixed in 11.1.1 |
Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.
| package | registry | version | runtime | secrets |
|---|---|---|---|---|
@three-ws/x402-mcp | npm | 0.2.3 | npx | SOLANA_SECRET_KEY |
No tools observed. Local packages are never executed by the registry.
Schemas: list_tools.
50 other active names share this repository (showing 10): io.github.nirholas/3d-agent-mcp, io.github.nirholas/3D-AI-Agent-Avatar, io.github.nirholas/activity-mcp, io.github.nirholas/agenc-mcp, io.github.nirholas/agentcore-payments-mcp, io.github.nirholas/agent-sniper, io.github.nirholas/agora-mcp, io.github.nirholas/alerts-mcp, io.github.nirholas/alibaba-cloud, io.github.nirholas/assistant-widget
And 73 more from this publisher.
{
"name": "io.github.nirholas/x402-mcp",
"icons": [
{
"src": "https://three.ws/three-ws-mcp-icon.svg",
"sizes": [
"any"
],
"mimeType": "image/svg+xml"
}
],
"title": "x402 Wallet",
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"version": "0.2.3",
"packages": [
{
"version": "0.2.3",
"transport": {
"type": "stdio"
},
"identifier": "@three-ws/x402-mcp",
"runtimeHint": "npx",
"registryType": "npm",
"environmentVariables": [
{
"name": "SOLANA_SECRET_KEY",
"format": "string",
"isSecret": true,
"description": "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."
},
{
"name": "SOLANA_RPC_URL",
"format": "string",
"default": "https://api.mainnet-beta.solana.com",
"description": "Solana mainnet RPC endpoint. Defaults to the public cluster — bring your own (Helius / Quicknode / Triton) for production traffic."
},
{
"name": "MAX_PAY_USD",
"format": "number",
"default": "1",
"description": "Max USD a single pay_and_call may spend. Bounds a runaway or injected payment."
},
{
"name": "REQUIRE_CONFIRM",
"format": "boolean",
"default": "true",
"description": "When on (default), pay_and_call refuses until re-issued with confirm:true. Set 0/false to disable the gate."
},
{
"name": "THREE_WS_BASE",
"format": "string",
"default": "https://three.ws",
"description": "Base URL of the three.ws API that serves /api/bazaar/search for find_services. Override only when self-hosting."
}
]
}
],
"repository": {
"url": "https://github.com/nirholas/three.ws",
"source": "github",
"subfolder": "packages/x402-mcp"
},
"websiteUrl": "https://three.ws",
"description": "Self-custodial x402 wallet for AI agents: pay any service in USDC or $THREE from your own key."
}