402-mcp

Nostr: npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2

👁 Licencia MIT
👁 TypeScript
👁 Node
👁 Cobertura
👁 Nostr
👁 Patrocinadores de GitHub

Cliente MCP L402 + x402 que dota a los agentes de IA de agencia económica. Descubre, paga y consume cualquier API con pago restringido: sin registro humano, sin claves API, sin intermediarios.

• Descubre APIs de pago en Nostr: no se necesitan URLs de antemano

• Pago automático con Lightning (NWC), ecash de Cashu o alternativa de código QR para humanos

• Credenciales almacenadas en caché y cifradas en reposo (AES-256-GCM)

• Funciona con cualquier servidor L402: toll-booth, Aperture o cualquier implementación futura

Inicio rápido

1. Instalar

npx 402-mcp

2. Conectar a Claude Code

claude mcp add 402-mcp -- npx 402-mcp

3. Pruébalo

Pregúntale a Claude: "Busca APIs de chistes de pago usando l402-search": no necesitas monedero, solo descubrimiento.

¿Listo para realizar llamadas de pago? Consulta la guía de inicio rápido completa para configurar un monedero y ver cómo tu agente paga su primera llamada a la API.

Related MCP server: ag402-mcp

Cómo funciona

graph LR
 A["1. l402-config()"] --> B["2. l402-discover(url)"]
 B --> C["3. Agent reasons<br/>about pricing"]
 C --> D["4. l402-buy-credits()<br/>or l402-fetch()"]
 D --> E["5. l402-fetch(url)<br/>with credentials"]
 E --> F["6. Data returned<br/>+ balance cached"]

Ejemplo de sesión:

Agent: "I need routing data from routing.trotters.cc"

1. l402-config()
 -> nwcConfigured: true, maxAutoPaySats: 1000

2. l402-discover("https://routing.trotters.cc/api/route")
 -> 10 sats/request, toll-booth detected, tiers available

3. Agent reasons: "I need ~20 requests. The 500-sat tier
 gives 555 credits. Better value."

4. l402-buy-credits(url, amountSats=500)
 -> Paid 500 sats, received 555 credits

5. l402-fetch("https://routing.trotters.cc/api/route?from=...&to=...")
 -> 200 OK, route data, 545 credits remaining

Para obtener diagramas detallados de la arquitectura y el flujo de pagos, consulta docs/architecture.md.

Configuración

Selección de transporte y alternativa

Cuando un evento tipo 31402 anuncia múltiples URLs (una por transporte), 402-mcp selecciona la mejor según tu configuración:

1. Preferencia primero: si TRANSPORT_PREFERENCE=tor y hay una URL .onion disponible, se intenta primero.

2. Alternativa por disponibilidad: si el transporte preferido no es accesible (proxy no configurado, tiempo de espera agotado), el cliente recurre a la siguiente URL de la lista.

3. Predeterminado de Clearnet: si no se establece ninguna preferencia, se prueban las URLs de clearnet antes que las entradas .onion o HNS.

Los servicios pueden anunciar múltiples puntos de conexión para el mismo servicio (mismo precio, misma clave macaroon) en diferentes transportes. Esto es puramente por resistencia a la censura; no necesitas volver a autenticarte al cambiar de transporte. Para acceder a puntos de conexión Tor o HNS, debes configurar las variables de entorno de proxy/pasarela correspondientes mencionadas arriba.

Herramientas

L402 principal (cualquier servidor)

Extensiones de toll-booth

Métodos de pago

Tres carriles de pago, probados en orden de prioridad:

1. NWC (Nostr Wallet Connect): totalmente autónomo; paga desde tu monedero conectado

2. Cashu: totalmente autónomo; funde tokens de ecash para pagar facturas

3. Intervención humana: presenta código QR, consulta el estado de liquidación

El agente puede anular el método por llamada, o puedes configurar solo los métodos que desees.

l402-fetch maneja cuatro variantes de desafío HTTP 402 de forma transparente:

Seguridad

MAX_AUTO_PAY_SATS limita cualquier pago autónomo individual. Por encima de este límite, el agente debe solicitar la aprobación del humano. El agente puede leer este límite a través de l402-config y tenerlo en cuenta en las decisiones de compra.

Privacidad

402-mcp almacena las credenciales localmente solo en tu máquina (~/.402-mcp/credentials.json, cifradas en reposo). No se envían datos a terceros. Sin cuentas, sin seguimiento, sin analíticas. Los pagos utilizan Lightning o Cashu, seudónimos por diseño.

Ecosistema

Explora servicios L402 en vivo en 402.pub, el mercado descentralizado para APIs con pago restringido.

402-mcp es la alternativa agnóstica al carril de pago a lightning-agent-tools de Lightning Labs y x402 de Coinbase: no se requiere nodo Lightning, múltiples monederos, credenciales cifradas.

Utiliza las herramientas de Lightning Labs si quieres agentes que ejecuten su propio nodo Lightning. Utiliza 402-mcp si quieres agentes que paguen desde cualquier monedero sin infraestructura.

Consulta CONTRIBUTING.md para la configuración y directrices de desarrollo.

Creado por @forgesworn.

• Propinas Lightning: thedonkey@strike.me

• Nostr: npub1mgvlrnf5hm9yf0n5mf9nqmvarhvxkc6remu5ec3vf8r0txqkuk7su0e7q2

Parte del kit de herramientas ForgeSworn

ForgeSworn construye herramientas de identidad criptográfica, pagos y coordinación de código abierto para Nostr.

Licencia

MIT

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?Related Servers