captcha-mcp

L402 Lightning paywall y PoW gate para llamadas de herramientas MCP. El nivel gratuito resuelve un desafío Hashcash; el nivel pago paga una factura Lightning a través de LNBits autoalojado. Sin cuentas, sin claves API.

GitHub

Prueba este MCPPatrocinado

Documentación

@powforge/captcha-mcp

Tu servidor MCP devuelve 429 cuando los agentes lo golpean. captcha-mcp hace que se ganen su siguiente llamada. Entrega al agente un rompecabezas de prueba de trabajo (gratis, ~5s de CPU) o una factura Lightning de 3 sats — ambas son señales de retroceso legibles por máquina que un llamador autónomo puede satisfacer sin cuenta, correo electrónico o clave API.

Tres herramientas sobre stdio o HTTP. Solo biblioteca estándar. Sin registro, respaldo gratuito, autoalojado, sin reparto de ingresos.

¿Por qué no 429?

429 Too Many Requests es la forma incorrecta para la era de los agentes. Tres patrones se repiten en los informes de servidores MCP:

Los marcos de agentes tratan 429 como un fallo de conexión. Reintentan inmediatamente, a menudo con retroceso exponencial que sigue siendo demasiado agresivo, y amplifican la sobrecarga que provocó el límite en primer lugar.
No hay señal por llamador. Un 429 se dispara para el grupo, no para el agente. Un llamador ruidoso hace que todos los demás llamadores sean limitados, y el servidor no tiene forma de pedirle específicamente al ruidoso que reduzca la velocidad.
Retry-After es informativo y frecuentemente ignorado. Los agentes no lo analizan de manera consistente, no lo respetan de manera consistente, y no tienen incentivo para esperar — el costo de reintentar es cero.

captcha-mcp reemplaza el 429 con un desafío estilo 402. La siguiente llamada le cuesta al llamador algo (segundos de CPU o 3 sats). Ese costo es por llamador, legible por máquina y auto-limitante — un agente que no puede resolver el rompecabezas no puede inundar el endpoint.

Inicio rápido

npx -y @powforge/captcha-mcp

Sin instalación, sin configuración, sin clave API. El servidor se inicia en stdio y espera un cliente MCP.

Para conectarlo a Claude Code, Cursor o cualquier host compatible con MCP, agrégalo a tu configuración:

{
  "mcpServers": {
    "powforge-captcha": {
      "command": "npx",
      "args": ["-y", "@powforge/captcha-mcp"]
    }
  }
}

O ejecuta npx @powforge/captcha-mcp --install para imprimir el bloque de configuración.

Qué hace

Envuelve el servicio pow-captcha de PowForge (captcha.powforge.dev) como tres herramientas MCP:

Herramienta	Propósito
`challenge`	Solicita un rompecabezas de prueba de trabajo nuevo. Devuelve `{id, salt, difficulty, signature}`.
`verify`	Envía un nonce resuelto. Devuelve un token de acceso firmado con HMAC de 5 minutos.
`status`	Salud del servidor, estadísticas de por vida, metadatos del endpoint L402.

El nivel gratuito cuesta al agente ~5-10 segundos de tiempo de CPU (SHA-256, 14 bits cero iniciales por defecto). El nivel de pago cuesta 3 sats sobre Lightning vía L402 (RFC 7235 + factura bolt11 en WWW-Authenticate).

Por qué esto y no OAuth, claves API o Stripe

Enfoque	Costo por llamada	Cuenta requerida	Autoalojado	Amigable con agentes
Claves API	$0	sí	n/a	no
OAuth	$0	sí	n/a	no
Medición Stripe	alto overhead	sí	n/a	no
Plataforma de autenticación MCP gestionada	100–2000 sats	no	no	sí
PoW + L402 (esto)	segundos o 3 sats	no	sí	sí

Los agentes no tienen direcciones de correo electrónico. No hacen clic en enlaces de confirmación. No ingresan tarjetas de crédito. PoW + Lightning es el único primitivo de autenticación que funciona para llamadores totalmente autónomos.

Las plataformas de autenticación MCP gestionadas funcionan, pero cobran 100–2000 sats por llamada en infraestructura de proveedor — tus ingresos fluyen a través de sus rieles. Este paquete se ejecuta en tu servidor, tu nodo Lightning, tus claves. Tú te quedas con los sats.

Configuración

Establece CAPTCHA_URL para apuntar a un backend de captcha diferente. El valor predeterminado es http://localhost:3077 para que puedas ejecutar toda la pila localmente para desarrollo. Los despliegues de producción lo apuntan a https://captcha.powforge.dev.

CAPTCHA_URL=https://captcha.powforge.dev npx @powforge/captcha-mcp

Transporte HTTP Streamable

Los clientes MCP alojados (Smithery, hosts basados en navegador) necesitan HTTP, no stdio. Pasa --http o establece HTTP_MODE=1:

HTTP_MODE=1 PORT=3200 npx @powforge/captcha-mcp
# or
npx @powforge/captcha-mcp --http

El servidor entonces escucha en:

Endpoint	Método	Propósito
`/mcp`	POST	Solicitud JSON-RPC única, respuesta JSON-RPC única. Las notificaciones devuelven 202.
`/mcp`	GET	Flujo SSE para notificaciones enviadas por el servidor (mantenido abierto con un latido de 25s).
`/health`	GET	Sonda de actividad — devuelve `{ok, server, transport}`. No es parte de MCP.

Sin estado. Sin IDs de sesión. CORS abierto (Access-Control-Allow-Origin: *) para que los clientes de navegador funcionen. El modo stdio no cambia y sigue siendo el predeterminado — npx @powforge/captcha-mcp sin bandera todavía habla JSON-RPC sobre stdin/stdout.

Prueba de humo del transporte HTTP:

HTTP_MODE=1 PORT=3200 node src/server.js &
curl -X POST http://localhost:3200/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}'

Devuelve {jsonrpc:"2.0", id:1, result:{protocolVersion:"2024-11-05", capabilities:{tools:{}}, serverInfo:{...}}}.

Desarrollo local

Clona el repositorio del widget captcha o ejecuta el servicio público. El servidor MCP solo necesita acceso HTTP a los endpoints de captcha listados bajo status.

git clone https://github.com/zekebuilds-lab/captcha-mcp
cd captcha-mcp
node src/server.js

Imprime ready en stderr y espera JSON-RPC en stdin.

Prueba de humo del protocolo manualmente:

echo '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"1"}}}' | node src/server.js

Deberías ver una respuesta JSON con serverInfo: { name: "@powforge/captcha-mcp", version: "0.2.5" }.

Verificación de token desde tu propio backend

Cuando un agente envía un token a tu servicio, verifícalo sin confiar en el agente:

curl -X POST https://captcha.powforge.dev/api/token/verify \
  -H "Content-Type: application/json" \
  -d '{"token":"<token-from-verify-tool>"}'

Devuelve {valid: true, method, issued_at, expires_at} o {valid: false, reason}.

Paquetes relacionados

@powforge/captcha — el widget de navegador para el mismo servicio.
@powforge/mcp-l402-gate — middleware Express para proteger cualquier servidor MCP con L402 + puntuación de Profundidad de Identidad.
@powforge/mcp-identity — oráculo de reputación de agentes. Combínalo con esta protección para protección contra abuso en la primera llamada.

Cómo se compara esto con otros primitivos de autenticación de agentes MCP

El espacio de proteger-el-servidor-MCP se está llenando. Aquí está el panorama honesto, clasificado por cuán directamente cada herramienta se superpone con lo que hace captcha-mcp.

Herramienta	Riel de pago	Modelo de autenticación	Autoalojado	Nivel PoW gratuito	Sin cuenta para pagar
PayGated	Créditos Stripe	Clave API + OAuth 2.1 + PKCE + M2M	sí (MIT)	no	no (registro de cliente Stripe por llamador)
APort	ninguno divulgado	Credenciales verificables W3C, gancho pre-herramienta	socio de diseño	no	n/a (audita, no cobra)
AgentSign	ninguno divulgado	Pasaporte firmado Ed25519 + puerta de confianza	desconocido	no	n/a
x402-mcp	USDC en cadena	firma de billetera	sí	no	no (necesita billetera financiada)
Autenticación MCP gestionada (Auth0 para IA, MintMCP)	SaaS	OAuth 2.0 / SAML / SSO	no	no	no
captcha-mcp (esto)	Lightning (L402)	Puerta PoW + omisión L402 + nivel gratuito	sí	sí	sí

PayGated es la colisión más cercana. Mismo discurso de "monetizar herramientas MCP por llamada", misma postura de autoalojado + código abierto, pero se asienta en Stripe. Eso significa que necesitas una cuenta de Stripe en buen estado (KYC, un banco, un país compatible) para cobrar, y cada llamador necesita un registro de cliente de Stripe antes de poder pagarte un centavo. El diferenciador de captcha-mcp es el camino sin cuenta: un autor no estadounidense paga 3 sats por llamada en unos 200ms sin KYC, o resuelve un rompecabezas PoW gratuito si no pagará en absoluto.

APort y AgentSign se sitúan en una capa diferente. Registran quién usó una herramienta bajo qué autoridad; no fijan el precio de la llamada. Se componen con una protección como esta en lugar de reemplazarla.

Ninguno de ellos fija el precio del acto de interactuar. Cada otra fila asume que el llamador ya es una identidad autorizada y mide o audita después de eso. El nivel PoW aquí es el único mecanismo en la tabla que pone un costo en la interacción misma, no en la identidad del actor. Esa es la posición que este paquete defiende.

Un desglose más largo contra x402-mcp, @agentauth/mcp y Cloudflare ARC/ACT está en powforge.dev/mcp/compare/x402-mcp.

Licencia

MIT