x402 Universal Payer

Name: x402 Universal Payer
Author: nirholas

de nirholasversión 1.0.2i★ 278 (Estrellas de todo el repositorio)iSe ejecuta en tu computadora

Nombre en el registroio.github.nirholas/x402-bridge

Cómo instalar

What it does

Pay any x402 endpoint on the open web: auto-paying bridge with Bazaar discovery and spend caps.

Connects Se ejecuta en tu computadora
Account or key Needs MCP_BRIDGE_EVM_PRIVATE_KEY, MCP_BRIDGE_SVM_PRIVATE_KEY
Category Otros

Instalación

Elige la app de IA que usas y copia la configuración.

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 13 nov 2026

Primero: ¿qué IA usas?

ClaudeWeb · app · móvilChatGPTWebClaude CodeTerminalCursorEditor de códigoVS CodeEditor de códigoOtrasOtras apps

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Necesitas una clave de x402 Universal Payer (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Instala Node.js
Una sola vez; sirve para todos los servidores que necesitan Node.js
Abrir la página de descarga de Node.js ↗
Hecho
Regístrate y crea una clave de x402 Universal Payer
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Abrir el sitio de x402 Universal Payer ↗
Hecho
Abre el archivo de configuración de la app de Claude de escritorio
SettingsDeveloperEdit Config
Hecho

Pega esta configuración y guarda el archivo

{
  "mcpServers": {
    "x402-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/mcp-bridge"
      ],
      "env": {
        "MCP_BRIDGE_EVM_PRIVATE_KEY": "your-value",
        "MCP_BRIDGE_SVM_PRIVATE_KEY": "your-value",
        "MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC": "your-value",
        "MCP_BRIDGE_MAX_TOTAL_ATOMIC": "your-value",
        "MCP_BRIDGE_ALLOWED_PAYTO": "your-value",
        "MCP_BRIDGE_ALLOWED_HOSTS": "your-value",
        "MCP_BRIDGE_ALLOW_HTTP": "your-value",
        "MCP_BRIDGE_DISCOVER_LIMIT": "your-value",
        "MCP_BRIDGE_BAZAAR_URL": "your-value",
        "MCP_BRIDGE_BATCH_DEPOSIT_MULTIPLIER": "your-value",
        "MCP_BRIDGE_MAX_DEPOSIT_ATOMIC": "your-value",
        "X402_MCP_BRIDGE_CHANNELS_DIR": "your-value",
        "RPC_URL_8453": "your-value"
      }
    }
  }
}

Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

Hecho

Cierra Claude y vuelve a abrirlo
Hecho
Pruébalo
Usa x402 Universal Payer y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Claude dice que está usando x402 Universal Payer o muestra una herramienta de x402 Universal Payer en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar x402 Universal Payer

x402 Universal Payer se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar x402 Universal Payer

Pasos para Claude →Necesitas una clave de x402 Universal Payer (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Pasos para Claude Code →Necesitas una clave de x402 Universal Payer (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Pasos para Cursor →Necesitas una clave de x402 Universal Payer (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Pasos para VS Code →Necesitas una clave de x402 Universal Payer (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)

B · Otros en Otros que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Hostinger✓ ChatGPT
World Monitor✓ ChatGPT
Svelte MCP✓ ChatGPT

Funciona con Claude Code, pero hay que preparar algo antes

Necesitas una clave de x402 Universal Payer (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)

Instala Node.js
Una sola vez; sirve para todos los servidores que necesitan Node.js
Abrir la página de descarga de Node.js ↗
Hecho
Regístrate y crea una clave de x402 Universal Payer
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Abrir el sitio de x402 Universal Payer ↗
Hecho
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
Hecho

Pega este comando y pulsa Enter

claude mcp add --scope user x402-bridge --env MCP_BRIDGE_EVM_PRIVATE_KEY=your-value --env MCP_BRIDGE_SVM_PRIVATE_KEY=your-value --env MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC=your-value --env MCP_BRIDGE_MAX_TOTAL_ATOMIC=your-value --env MCP_BRIDGE_ALLOWED_PAYTO=your-value --env MCP_BRIDGE_ALLOWED_HOSTS=your-value --env MCP_BRIDGE_ALLOW_HTTP=your-value --env MCP_BRIDGE_DISCOVER_LIMIT=your-value --env MCP_BRIDGE_BAZAAR_URL=your-value --env MCP_BRIDGE_BATCH_DEPOSIT_MULTIPLIER=your-value --env MCP_BRIDGE_MAX_DEPOSIT_ATOMIC=your-value --env X402_MCP_BRIDGE_CHANNELS_DIR=your-value --env RPC_URL_8453=your-value -- npx -y @three-ws/mcp-bridge

Cambia “your-value” por tu clave antes de pulsar Enter

Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

Hecho

Escribe /mcp en Claude Code
Deberías ver x402 Universal Payer en la lista como conectado
Hecho
Pruébalo
Usa x402 Universal Payer y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Claude Code dice que está usando x402 Universal Payer o muestra una herramienta de x402 Universal Payer en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Necesitas una clave de x402 Universal Payer (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)

Instala Node.js
Una sola vez; sirve para todos los servidores que necesitan Node.js
Abrir la página de descarga de Node.js ↗
Hecho
Regístrate y crea una clave de x402 Universal Payer
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Abrir el sitio de x402 Universal Payer ↗
Hecho
Pulsa este botón para abrir Cursor
Abrir en Cursor
Cursor te pedirá confirmar; pulsa Install
Hecho
Escribe tu clave
En la configuración de x402 Universal Payer, MCP_BRIDGE_EVM_PRIVATE_KEY, MCP_BRIDGE_SVM_PRIVATE_KEY, MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC, MCP_BRIDGE_MAX_TOTAL_ATOMIC, MCP_BRIDGE_ALLOWED_PAYTO, MCP_BRIDGE_ALLOWED_HOSTS, MCP_BRIDGE_ALLOW_HTTP, MCP_BRIDGE_DISCOVER_LIMIT, MCP_BRIDGE_BAZAAR_URL, MCP_BRIDGE_BATCH_DEPOSIT_MULTIPLIER, MCP_BRIDGE_MAX_DEPOSIT_ATOMIC, X402_MCP_BRIDGE_CHANNELS_DIR, RPC_URL_8453 está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Hecho
Abre el chat de IA de Cursor en modo Agent
Hecho
Pruébalo
Usa x402 Universal Payer y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si Cursor dice que está usando x402 Universal Payer o muestra una herramienta de x402 Universal Payer en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Necesitas una clave de x402 Universal Payer (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)

Instala Node.js
Una sola vez; sirve para todos los servidores que necesitan Node.js
Abrir la página de descarga de Node.js ↗
Hecho
Regístrate y crea una clave de x402 Universal Payer
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Abrir el sitio de x402 Universal Payer ↗
Hecho
Pulsa este botón para abrir VS Code
Abrir en VS Code
VS Code te pedirá confirmar; pulsa Install
Hecho
Escribe tu clave
En la configuración de x402 Universal Payer, MCP_BRIDGE_EVM_PRIVATE_KEY, MCP_BRIDGE_SVM_PRIVATE_KEY, MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC, MCP_BRIDGE_MAX_TOTAL_ATOMIC, MCP_BRIDGE_ALLOWED_PAYTO, MCP_BRIDGE_ALLOWED_HOSTS, MCP_BRIDGE_ALLOW_HTTP, MCP_BRIDGE_DISCOVER_LIMIT, MCP_BRIDGE_BAZAAR_URL, MCP_BRIDGE_BATCH_DEPOSIT_MULTIPLIER, MCP_BRIDGE_MAX_DEPOSIT_ATOMIC, X402_MCP_BRIDGE_CHANNELS_DIR, RPC_URL_8453 está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Hecho
Abre el chat de IA de VS Code en modo Agent
Hecho
Pruébalo
Usa x402 Universal Payer y dime qué puedes hacer por mí; luego muéstrame una cosa
✓ Si VS Code dice que está usando x402 Universal Payer o muestra una herramienta de x402 Universal Payer en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa x402 Universal Payer💬 Conversación →

Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user x402-bridge --env MCP_BRIDGE_EVM_PRIVATE_KEY=your-value --env MCP_BRIDGE_SVM_PRIVATE_KEY=your-value --env MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC=your-value --env MCP_BRIDGE_MAX_TOTAL_ATOMIC=your-value --env MCP_BRIDGE_ALLOWED_PAYTO=your-value --env MCP_BRIDGE_ALLOWED_HOSTS=your-value --env MCP_BRIDGE_ALLOW_HTTP=your-value --env MCP_BRIDGE_DISCOVER_LIMIT=your-value --env MCP_BRIDGE_BAZAAR_URL=your-value --env MCP_BRIDGE_BATCH_DEPOSIT_MULTIPLIER=your-value --env MCP_BRIDGE_MAX_DEPOSIT_ATOMIC=your-value --env X402_MCP_BRIDGE_CHANNELS_DIR=your-value --env RPC_URL_8453=your-value -- npx -y @three-ws/mcp-bridge

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "x402-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/mcp-bridge"
      ],
      "env": {
        "MCP_BRIDGE_EVM_PRIVATE_KEY": "your-value",
        "MCP_BRIDGE_SVM_PRIVATE_KEY": "your-value",
        "MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC": "your-value",
        "MCP_BRIDGE_MAX_TOTAL_ATOMIC": "your-value",
        "MCP_BRIDGE_ALLOWED_PAYTO": "your-value",
        "MCP_BRIDGE_ALLOWED_HOSTS": "your-value",
        "MCP_BRIDGE_ALLOW_HTTP": "your-value",
        "MCP_BRIDGE_DISCOVER_LIMIT": "your-value",
        "MCP_BRIDGE_BAZAAR_URL": "your-value",
        "MCP_BRIDGE_BATCH_DEPOSIT_MULTIPLIER": "your-value",
        "MCP_BRIDGE_MAX_DEPOSIT_ATOMIC": "your-value",
        "X402_MCP_BRIDGE_CHANNELS_DIR": "your-value",
        "RPC_URL_8453": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "x402-bridge": {
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/mcp-bridge"
      ],
      "env": {
        "MCP_BRIDGE_EVM_PRIVATE_KEY": "your-value",
        "MCP_BRIDGE_SVM_PRIVATE_KEY": "your-value",
        "MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC": "your-value",
        "MCP_BRIDGE_MAX_TOTAL_ATOMIC": "your-value",
        "MCP_BRIDGE_ALLOWED_PAYTO": "your-value",
        "MCP_BRIDGE_ALLOWED_HOSTS": "your-value",
        "MCP_BRIDGE_ALLOW_HTTP": "your-value",
        "MCP_BRIDGE_DISCOVER_LIMIT": "your-value",
        "MCP_BRIDGE_BAZAAR_URL": "your-value",
        "MCP_BRIDGE_BATCH_DEPOSIT_MULTIPLIER": "your-value",
        "MCP_BRIDGE_MAX_DEPOSIT_ATOMIC": "your-value",
        "X402_MCP_BRIDGE_CHANNELS_DIR": "your-value",
        "RPC_URL_8453": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "x402-bridge": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@three-ws/mcp-bridge"
      ],
      "env": {
        "MCP_BRIDGE_EVM_PRIVATE_KEY": "your-value",
        "MCP_BRIDGE_SVM_PRIVATE_KEY": "your-value",
        "MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC": "your-value",
        "MCP_BRIDGE_MAX_TOTAL_ATOMIC": "your-value",
        "MCP_BRIDGE_ALLOWED_PAYTO": "your-value",
        "MCP_BRIDGE_ALLOWED_HOSTS": "your-value",
        "MCP_BRIDGE_ALLOW_HTTP": "your-value",
        "MCP_BRIDGE_DISCOVER_LIMIT": "your-value",
        "MCP_BRIDGE_BAZAAR_URL": "your-value",
        "MCP_BRIDGE_BATCH_DEPOSIT_MULTIPLIER": "your-value",
        "MCP_BRIDGE_MAX_DEPOSIT_ATOMIC": "your-value",
        "X402_MCP_BRIDGE_CHANNELS_DIR": "your-value",
        "RPC_URL_8453": "your-value"
      }
    }
  }
}

Valores que debes completar

MCP_BRIDGE_EVM_PRIVATE_KEY secreto env
0x-prefixed 32-byte hex private key that funds USDC payments on EVM chains (Base, Arbitrum, …). At least one of the EVM/SVM keys is required. Treat like cash — use a dedicated low-balance wallet.
MCP_BRIDGE_SVM_PRIVATE_KEY secreto env
Solana secret key that funds USDC payments: base58 64-byte secret key (Phantom / solana-keygen format) or a JSON array of 64 integers. At least one of the EVM/SVM keys is required. Treat like cash.
MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC env
Per-call spending cap in atomic units (USDC has 6 decimals). Payments above this abort with a clear reason.
MCP_BRIDGE_MAX_TOTAL_ATOMIC env
Cumulative session spending ceiling in atomic units. Once total spend would exceed it, further payments abort until restart.
MCP_BRIDGE_ALLOWED_PAYTO env
Comma-separated payee allowlist. When set, any payment whose payTo address is not listed is refused.
MCP_BRIDGE_ALLOWED_HOSTS env
Comma-separated hostname allowlist for outbound paid requests. When set, any other host is refused before a request is signed.
MCP_BRIDGE_ALLOW_HTTP env
Set to 1 to allow http:// targets (local development only). https is enforced otherwise.
MCP_BRIDGE_DISCOVER_LIMIT env
Max number of x402 Bazaar resources to register as dynamic tools at startup. Set 0 to disable discovery.
MCP_BRIDGE_BAZAAR_URL env
x402 Bazaar discovery endpoint. Override to point at a self-hosted or alternative bazaar.
MCP_BRIDGE_BATCH_DEPOSIT_MULTIPLIER env
How many request-amounts to deposit at once when opening an EVM batch-settlement channel.
MCP_BRIDGE_MAX_DEPOSIT_ATOMIC env
Hard cap in atomic units on a single batch-settlement channel deposit or top-up.
X402_MCP_BRIDGE_CHANNELS_DIR env
Directory for persisted batch-settlement channel state (survives client restarts).
RPC_URL_8453 env
Per-chain RPC override, one variable per chain id (RPC_URL_ , e.g. RPC_URL_8453 for Base). Defaults to viem's public RPC for that chain.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Estrellas de GitHub i: 278 (Estrellas de todo el repositorio)
Este repositorio tiene varias fichas MCP; sus estrellas cuentan una sola vez en las clasificaciones
Descargas por semanai: 56/sem
Licencia i: Apache-2.0
Conexión: Se ejecuta en tu computadora
Transporte: stdio
Última versióni: 1.0.2
Categoríai: Otros
Publicado en el registroi: 20 ago 2026
Último cambio de códigoi: 13 nov 2026
Creador: nirholas
Paquetes: npm: @three-ws/mcp-bridge
Repo: nirholas/three.ws
Sitio web: three.ws
Estado en el registro: Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

Claude Goose LM Studio Msty Studio Cherry Studio Cursor VS Code + GitHub Copilot Visual Studio Windsurf (Devin Desktop)Zed Kiro Cline Continue JetBrains AI Assistant Claude Code Codex CLI Gemini CLI OpenCode nodecode Warp LibreChat Raycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 13 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub nirholas, dueña del repo
✓ Superada
Sigue en mantenimiento
Último cambio de código: hoy
✓ Superada
Tiene licencia
Usa Apache-2.0
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión con Google para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión con Google para escribir una reseña

Comparado con otros en Otrosi

Más estrellas que el 0% de los otros 19659 servidores de esta categoría
Publicado en el registro más recientemente que el 23% de los otros 19659 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 19659 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro x402 Universal Payer?

Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: MCP_BRIDGE_EVM_PRIVATE_KEY, MCP_BRIDGE_SVM_PRIVATE_KEY

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hoy, y la última versión (1.0.2) llegó al registro hace 3 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: World Monitor, Claude Flow, Windmill

Otros de la misma categoría

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 102 tools.

de koala73Muy usado★ 90,6 milActualizado hoy

Se ejecuta en la nube✓ del servicio · worldmonitor.app

Cómo conectar

Claude Flow

AI orchestration with hive-mind swarms, neural networks, and 87 MCP tools for enterprise dev.

de ruvnetMuy usado↓ 13,5 mil/sem★ 81,6 milActualizado hace 14 meses

Se ejecuta en tu computadora

Instalar

Windmill

Run Windmill scripts and flows and manage jobs, schedules, resources and variables.

de windmill-labsMuy usado★ 18,6 milActualizado ayer

Se ejecuta en la nube

Cómo conectar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

@three-ws/mcp-bridge

One MCP server that can pay any x402-paid endpoint on the open web — the universal x402 payer for AI agents.

Quick start · Security · Tools · Environment · three.ws

A Model Context Protocol server that can pay any x402-paid endpoint on the open web. Point your agent at a URL that answers 402 Payment Required; the bridge signs, pays, retries, and hands back the response plus the settlement receipt — EVM exact, EVM batch-settlement, and Solana exact, all behind hard spending caps. It also pre-loads a tool per service discovered on the Coinbase x402 Bazaar, so the entire paid-API economy shows up in your tool list.

Quick start

Claude Code:

claude mcp add x402-bridge -e MCP_BRIDGE_SVM_PRIVATE_KEY=... -- npx -y @three-ws/mcp-bridge

Use -e MCP_BRIDGE_EVM_PRIVATE_KEY=0x... instead (or as well) to pay on Base and other EVM chains. At least one key is required.

Claude Desktop (claude_desktop_config.json) or Cursor (~/.cursor/mcp.json):

"mcpServers": { "x402-bridge": { "command": "npx", "args": ["-y", "@three-ws/mcp-bridge"], "env": { "MCP_BRIDGE_EVM_PRIVATE_KEY": "0x…buyer key…", "MCP_BRIDGE_SVM_PRIVATE_KEY": "…base58 64-byte secret key…", "MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC": "100000", "MCP_BRIDGE_DISCOVER_LIMIT": "20" } } } }

Restart the client and ask for something like "pay $0.01 on Base for a weather report" — the model picks a matching Bazaar tool (or call_paid_endpoint), and the bridge auto-pays via x402.

Security and spending controls

This server holds private keys and spends real USDC. Read this section before configuring it.

Use a dedicated, low-balance wallet. MCP_BRIDGE_EVM_PRIVATE_KEY / MCP_BRIDGE_SVM_PRIVATE_KEY should never be a main wallet. Fund it with only what you are willing to let an agent spend.
Per-call cap. Any payment above MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC (default 100000 = $0.10 USDC) is refused before a payload is signed, with an error naming the network, asset, and cap.
Session ceiling. Cumulative spend per process is capped by MCP_BRIDGE_MAX_TOTAL_ATOMIC (default 1000000 = $1.00 USDC). This bounds the damage of a looping or prompt-injected agent: once the ceiling is reached, every further payment aborts until restart. The accumulator reserves atomically, so concurrent calls cannot jointly overshoot it.
Payee allowlist. Set MCP_BRIDGE_ALLOWED_PAYTO (comma-separated addresses) to refuse payment to any recipient you have not explicitly trusted.
SSRF guard. Every outbound payable URL — whether supplied by the model or by a Bazaar listing — passes one chokepoint that enforces an https-only scheme policy, resolves the hostname, and rejects the request if any resolved address is private, loopback, link-local (including 169.254.169.254 cloud metadata), CGNAT, ULA, or unspecified. Literal-IP hosts are checked directly; redirects are never followed (a public host cannot 3xx the bridge into internal infrastructure). http:// is available only behind the explicit MCP_BRIDGE_ALLOW_HTTP=1 dev opt-in.
Host allowlist. Set MCP_BRIDGE_ALLOWED_HOSTS (comma-separated hostnames) for strict mode: only listed hosts can be paid at all.
Deposit caps. Batch-settlement channel deposits are bounded by MCP_BRIDGE_MAX_DEPOSIT_ATOMIC (default $5.00) regardless of what a server requests.
Honest annotations. Every paying tool is annotated readOnlyHint: false, idempotentHint: false, openWorldHint: true, so MCP hosts apply their strictest confirmation policy. Retrying a paid call is a new charge.

What it exposes

On startup the bridge registers:

Tool	What it does
`call_paid_endpoint`	Universal fallback: hit any URL, auto-pay if it returns 402. Returns the response + parsed settlement.
`list_bazaar_tools`	Returns the cached list of Bazaar-discovered tools (name, resource, accepted payment terms). Free.
`refresh_bazaar`	Re-queries the x402 Bazaar and re-registers dynamic tools without restarting. Free.
`paid_` …	One tool per discovered Bazaar resource (up to `MCP_BRIDGE_DISCOVER_LIMIT`), with that endpoint's schema.

Tools whose prices all exceed the per-call cap are filtered out at discovery time, so the model never sees a tool it cannot afford.

Tool annotations

Every tool carries MCP ToolAnnotations so hosts can apply the right confirmation policy:

call_paid_endpoint and every dynamic paid_* tool: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true. These spend real USDC — each call settles a payment (capped by MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC), and retrying is a new charge. They never delete or overwrite caller state, hence not destructive.
list_bazaar_tools: readOnlyHint: true, idempotentHint: true, openWorldHint: false. Pure in-process cache read; free, no network.
refresh_bazaar: readOnlyHint: false, destructiveHint: false, idempotentHint: false, openWorldHint: true. Free (no payment), but it mutates the registered tool set from the live Bazaar feed, so repeat calls can differ.

Tool results that are plain objects are returned as both a JSON text block (backward compatible) and structuredContent for typed clients.

Payment schemes

Payment paths registered on the buyer client:

eip155:* → BatchSettlementEvmScheme (preferred when the server advertises it; voucher-based, no per-call gas)
eip155:* → ExactEvmScheme (used when the server advertises scheme: "exact")
solana:* and the x402 v1 Solana networks (solana, solana-devnet, solana-testnet) → ExactSvmScheme / ExactSvmSchemeV1 (USDC SPL transfer co-signed by the advertised fee payer), registered together by registerExactSvmScheme(). v1 is the wire format most of the open x402 bazaar still speaks; the client always prefers v2 when a seller advertises both. The spending-cap hook reads either amount (v2) or maxAmountRequired (v1) so both are capped the same way.

Batch-settlement channel state is persisted to ~/.x402-mcp-bridge/channels/client/ so client restarts do not re-deposit on the next call.

Environment

Variable	Required	Default	Notes
`MCP_BRIDGE_EVM_PRIVATE_KEY`	one of EVM/SVM required	—	0x-prefixed 32-byte hex. Funds USDC payments on Base, Arbitrum, etc.
`MCP_BRIDGE_SVM_PRIVATE_KEY`	one of EVM/SVM required	—	base58 64-byte secret key (Phantom/solana-keygen format) or 64-int JSON array.
`MCP_BRIDGE_MAX_PRICE_PER_CALL_ATOMIC`	no	`100000` (= $0.10 USDC at 6 decimals)	Per-call spending cap. Payment aborts above this with a clear reason.
`MCP_BRIDGE_MAX_TOTAL_ATOMIC`	no	`1000000` (= $1.00 USDC)	Cumulative session spending ceiling. Aborts further payments once reached.
`MCP_BRIDGE_ALLOWED_PAYTO`	no	— (any payee)	Comma-separated payee allowlist. When set, unlisted `payTo` addresses are refused.
`MCP_BRIDGE_ALLOWED_HOSTS`	no	— (any public host)	Comma-separated hostname allowlist for outbound paid requests.
`MCP_BRIDGE_ALLOW_HTTP`	no	`0`	Set `1` to allow `http://` targets. Local development only.
`MCP_BRIDGE_DISCOVER_LIMIT`	no	`20`	Max number of Bazaar tools to register dynamically. Set `0` to disable discovery.
`MCP_BRIDGE_BAZAAR_URL`	no	`https://api.cdp.coinbase.com/platform/v2/x402/discovery/resources`	Override to point at a self-hosted or alternative bazaar.
`MCP_BRIDGE_BATCH_DEPOSIT_MULTIPLIER`	no	`5`	How many request-amounts to deposit at once when opening a batch channel.
`MCP_BRIDGE_MAX_DEPOSIT_ATOMIC`	no	`5000000` (= $5.00 USDC)	Hard cap on the deposit amount per channel open / top-up.
`X402_MCP_BRIDGE_CHANNELS_DIR`	no	`~/.x402-mcp-bridge/channels`	Override the directory used by `FileClientChannelStorage`.
`RPC_URL_`	no	viem default public RPC	Per-chain RPC override. Example: `RPC_URL_8453=https://mainnet.base.org`.

MCP_BRIDGE_* key vars also fall back to EVM_PRIVATE_KEY / SVM_PRIVATE_KEY if you already have those set.

Spending cap behavior

The pre-payment hook inspects the selected accepts entry and aborts payload creation if the amount exceeds the per-call cap, the payee is outside the allowlist, or the session ceiling would be crossed. The tool result then carries a clear error message naming the network, asset, and the limit that was hit — useful for the model to decide whether to ask you to raise it.

Inspecting without a client

MCP_BRIDGE_SVM_PRIVATE_KEY=... npx -y @modelcontextprotocol/inspector npx -y @three-ws/mcp-bridge

The inspector connects over stdio and lists the static tools (call_paid_endpoint, list_bazaar_tools, `refresh_ba

Solo se muestra el principio; lee el resto en el repo

x402 Universal Payer

What it does

Instalación

Instala Node.js

Regístrate y crea una clave de x402 Universal Payer

Abre el archivo de configuración de la app de Claude de escritorio

Pega esta configuración y guarda el archivo

Cierra Claude y vuelve a abrirlo

Pruébalo

Lo que puedes hacer en su lugar

Instala Node.js

Regístrate y crea una clave de x402 Universal Payer

Abre la Terminal

Pega este comando y pulsa Enter

Escribe /mcp en Claude Code

Pruébalo

Instala Node.js

Regístrate y crea una clave de x402 Universal Payer

Pulsa este botón para abrir Cursor

Escribe tu clave

Abre el chat de IA de Cursor en modo Agent

Pruébalo

Instala Node.js

Regístrate y crea una clave de x402 Universal Payer

Pulsa este botón para abrir VS Code

Escribe tu clave

Abre el chat de IA de VS Code en modo Agent

Pruébalo

Instalado en tu computadora

Valores que debes completar

De un vistazo

Qué apps pueden usarlo

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Conversación

Reseñas de usuarios

Comparado con otros en Otrosi

Preguntas frecuentes

Otros de la misma categoría

World Monitor

Claude Flow

Windmill

README del creador

Quick start

Security and spending controls

What it exposes

Tool annotations

Payment schemes

Environment

Spending cap behavior

Inspecting without a client