HookSense

@hooksense/mcp

Servidor de Protocolo de Contexto de Modelo para HookSense — la capa de webhooks y callbacks para agentes de IA. Permite que Claude Desktop, Cursor, Claude Code, Continue y cualquier cliente MCP creen una URL de callback, esperen el resultado en lugar de hacer polling y verifiquen su firma — todo desde la sesión del agente.

Por qué

Los agentes que inician trabajo asíncrono — un despliegue, un render, una aprobación con intervención humana, una llamada de herramienta larga, otro agente — necesitan recibir el resultado sin quemar contexto en bucles de polling. Con este servidor, el agente crea un endpoint de callback, entrega la URL al trabajo y luego llama a wait_for_callback y es despertado en el instante en que llega el webhook — con firma verificada y descifrado. Deja de hacer polling para resultados asíncronos; espéralos.

Configuración

1. Obtén un token de API en https://hooksense.com/account/tokens
2. Configura tu cliente MCP (ejemplos abajo)

Claude Desktop / Claude Code

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) o %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "hooksense": {
      "command": "npx",
      "args": ["-y", "@hooksense/mcp"],
      "env": {
        "HOOKSENSE_TOKEN": "hsk_your_token_here"
      }
    }
  }
}

Cursor

Añade a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "hooksense": {
      "command": "npx",
      "args": ["-y", "@hooksense/mcp"],
      "env": {
        "HOOKSENSE_TOKEN": "hsk_your_token_here"
      }
    }
  }
}

Hola callback (60 segundos)

Una vez configurado, pide a tu agente:

1. Crear — "Crea un endpoint de callback." → el agente llama a create_callback_endpoint y recibe un callbackUrl como https://hooksense.com/w/ab12cd.
2. Disparar — apunta cualquier trabajo a esa URL (o simplemente curl -X POST <callbackUrl> -d '{"status":"done"}' desde otra terminal).
3. Esperar — "Espera el callback." → el agente llama a wait_for_callback y se bloquea hasta que llegue el webhook, luego recibe { status: "received", request: { body, headers, … } }.
4. Verificar (opcional) — establece un secreto de webhook en el endpoint, luego "Verifica la firma." → verify_signature confirma que el payload es auténtico antes de que el agente actúe sobre él.

Sin polling, sin paneles, sin copiar y pegar.

Herramientas

Herramienta	Descripción
create_callback_endpoint	Crea un endpoint de callback; devuelve el callbackUrl
wait_for_callback	Se bloquea hasta que llegue el siguiente callback, luego lo devuelve (cursor timeoutMs, after)
list_callbacks	Lista los callbacks recibidos por un endpoint (vista resumida)
get_callback_payload	Obtiene un callback con cabeceras completas + cuerpo descifrado
verify_signature	Verificación HMAC segura contra el secreto configurado del endpoint
replay_callback	Envía un callback recibido a cualquier URL de destino
list_endpoints	Lista tus endpoints
get_endpoint	Obtiene la configuración completa de un endpoint

Entorno

Variable	Predeterminado	Notas
HOOKSENSE_TOKEN	(obligatorio)	Token de API de /account/tokens
HOOKSENSE_API	https://hooksense.com	Anulación para autoalojado/staging

Ejemplos de prompts para agentes

"Crea un endpoint de callback, úsalo como webhook para mi predicción de Replicate y espera el resultado — luego resume la salida."

"Abre una URL de callback, entrégala al paso de aprobación y bloquea hasta que un humano apruebe antes de continuar."

"Espera el próximo callback de Stripe en payments-prod, verifica su firma y dime el monto."

Licencia

MIT