webhooks.cc

Pruebas de webhooks para agentes de codificación: crea endpoints, envía webhooks de prueba firmados, inspecciona las solicitudes capturadas, compara intentos y verifica firmas.

GitHub
2
Prueba este MCPPatrocinado

Documentación

webhooks.cc

Inspecciona y depura webhooks sin desplegar a producción.

Obtén una URL única, apunta tu webhook hacia ella y ve cada solicitud en tiempo real. No requiere registro.

Pruébalo ahora →

Primeros pasos

  1. Visita webhooks.cc
  2. Copia tu URL de webhook única
  3. Envía una solicitud de prueba: curl -X POST https://go.webhooks.cc/w/<slug> -d '{"test": true}'
  4. Obsérvala aparecer en el panel de control

Características

  • Captura solicitudes — Almacena webhooks entrantes con cabeceras, cuerpo, parámetros de consulta y metadatos
  • Inspecciona en tiempo real — Ve las solicitudes en el momento en que llegan vía WebSocket
  • Configura respuestas — Devuelve códigos de estado, cabeceras y cuerpo personalizados para probar rutas de error
  • Reenvía a localhost — Tuneliza webhooks a tu servidor local durante el desarrollo
  • CLI con TUI interactivo — Gestiona endpoints, túneles y transmite solicitudes desde tu terminal
  • SDK de TypeScript — Accede a los datos de webhook programáticamente para automatización y pruebas
  • Servidor MCP — Conecta agentes de codificación con IA (Claude Code, Cursor, VS Code, Codex) a tus webhooks

Casos de uso

Pruebas de integraciones de pago — Apunta los webhooks de prueba de Stripe a tu endpoint. Inspecciona la estructura del payload antes de escribir los manejadores.

Depuración de hooks de CI/CD — Ve exactamente lo que GitHub envía cuando ocurre un push, PR o despliegue.

Desarrollo local — Reenvía webhooks similares a producción a localhost sin exponer tu máquina a internet.

Simulación de escenarios de fallo — Configura tu endpoint para devolver errores 500 y prueba tu lógica de reintentos.

Precios

Gratis — 50 solicitudes/día, retención de datos de 7 días. Suficiente para desarrollo y pruebas.

Pro ($8/mes) — 100,000 solicitudes/mes, retención de 30 días. Para monitoreo de producción y pruebas de alto volumen.

Consulta webhooks.cc para más detalles.

Instalación

CLI

curl -fsSL https://webhooks.cc/install.sh | sh

Luego inicia el terminal interactivo:

whk

SDK

npm install @webhooks-cc/sdk

Servidor MCP

# Claude Code
claude mcp add -s user webhooks-cc -e WHK_API_KEY=whcc_... -- npx -y @webhooks-cc/mcp

# Cursor, VS Code, Windsurf, Claude Desktop
npx @webhooks-cc/mcp setup cursor --api-key whcc_...

Consulta webhooks.cc/installation para todos los métodos de instalación, botones de un clic y guías de configuración.

CLI

Ejecuta whk para iniciar el TUI interactivo:

$ whk

  webhooks.cc

  ● Logged in as you@example.com

  ▸ Tunnel    Forward webhooks to localhost
    Listen    Stream incoming requests
    Create    Create a new endpoint
    Endpoints Manage your endpoints
    Auth      Login / logout
    Update    Check for updates

Todos los comandos también funcionan directamente desde la línea de comandos:

whk tunnel 8080                       # Forward webhooks to localhost:8080
whk listen <slug>                     # Stream incoming requests
whk create my-endpoint                # Create a new endpoint
whk list                              # List your endpoints
whk replay <request-id> --to :3000    # Replay a captured request

Pasa --nogui o establece WHK_NOGUI=1 para omitir el TUI e imprimir la ayuda.

SDK

import { WebhooksCC, matchMethod, matchHeader, matchAll } from "@webhooks-cc/sdk";

const client = new WebhooksCC({ apiKey: "whcc_..." });

const endpoint = await client.endpoints.create({ name: "my-webhook" });
console.log(endpoint.url);

// Wait for a matching request with human-readable timeout
const req = await client.requests.waitFor(endpoint.slug, {
  timeout: "30s",
  match: matchAll(matchMethod("POST"), matchHeader("stripe-signature")),
});

// Replay captured requests to your local server
await client.requests.replay(req.id, "http://localhost:3000/webhooks");

Servidor MCP

El paquete @webhooks-cc/mcp expone 11 herramientas que permiten a los agentes de IA gestionar endpoints, inspeccionar webhooks, enviar payloads de prueba y reproducir solicitudes mediante lenguaje natural.

You: "Create a webhook endpoint for testing Stripe"
Agent: Created endpoint "stripe-test" at https://go.webhooks.cc/w/abc123

You: "Send a test checkout.session.completed event"
Agent: Sent POST to stripe-test

You: "Replay that to my local server"
Agent: Replayed to http://localhost:3000/webhooks — 200 OK

Consulta packages/mcp/README.md para la configuración completa y la referencia de herramientas.

Código abierto

El código fuente está disponible para transparencia y contribuciones de la comunidad, no como guía de despliegue. Para contribuir, consulta CONTRIBUTING.md.

Para entornos de cumplimiento o aislados, el código está aquí. Para la mayoría de los casos de uso, el servicio alojado en webhooks.cc es el camino más sencillo.

Licencia

Este proyecto utiliza una licencia dividida:

  • AGPL-3.0: la aplicación web, el receptor, el host SMTP de captura de correos y el backend de Supabase (apps/web/, apps/receiver-rs/, apps/mx-rs/, supabase/). Consulta LICENSE.
  • MIT: el CLI, SDK y servidor MCP (apps/cli-rs/, packages/sdk/, packages/mcp/). Consulta sus respectivos archivos LICENSE.

Si usas el CLI, SDK o servidor MCP en tus propios proyectos, aplica MIT. Si haces un fork y alojas el servicio, aplica AGPL-3.0.