Hooklayer MCP

Inteligencia de contenido viral para agentes de IA. Integra el servidor MCP de Hooklayer en Claude Desktop, Cursor, n8n o cualquier cliente MCP HTTP y tu agente obtiene 12 herramientas para contenido de formato corto en TikTok, Instagram y YouTube: analiza creadores, busca videos por palabra clave, encuentra plantillas virales y tendencias emergentes, puntúa y reescribe ganchos, remezcla videos virales, iguala la voz de un creador, predice la viralidad de un borrador, convierte un brief de marca en un plano creativo listo para grabar, y monitorea creadores a lo largo del tiempo con seguimientos guardados y capturas históricas.

12 tools · structured JSON · non-destructive creator monitoring · no external social-platform edits or deletes

v1.1.0 (2026-05-14): La capa de evidencia llega. Cada puntuación incluye signals[] con evidencia citada, un contrafactual would_fail_because y un campo de salud quality. predict_virality ejecuta una verificación adversarial independiente. Los pasos de analyze_account.recommended_chain ahora exponen confidence, cost, action_class (taxonomía de autoridad) y expected_output. Consulta CHANGELOG.md para el lanzamiento completo.

🚀 Instalación rápida

Claude Desktop

Claude Desktop no admite de forma nativa servidores MCP HTTP remotos; necesita el puente mcp-remote. Hay dos formas de instalarlo:

Opción 1 — Conector personalizado (la más fácil, sin editar archivos de configuración)

En la interfaz web/de escritorio de Claude: Configuración → Conectores → Añadir conector personalizado → pega esta URL:

https://hooklayer.dev/api/mcp

Claude.ai te guiará a través de OAuth (sin necesidad de pegar claves manualmente). Listo.

Opción 2 — Configuración directa (para usuarios avanzados que quieran autenticación con clave hl_live_)

Edita claude_desktop_config.json:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "hooklayer": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@0.1.38",
        "https://hooklayer.dev/api/mcp",
        "--header",
        "Authorization:Bearer hl_live_..."
      ]
    }
  }
}

Obtén tu clave gratuita hl_live_ en https://hooklayer.dev/auth/signup — 100 créditos de por vida, sin tarjeta.

Reinicia Claude Desktop. Las 12 herramientas de Hooklayer aparecen en la lista de conectores 🔌.

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "hooklayer": {
      "url": "https://hooklayer.dev/api/mcp",
      "transport": "http",
      "headers": {
        "Authorization": "Bearer hl_live_..."
      }
    }
  }
}

n8n

En tu flujo de trabajo, añade un nodo MCP Client y configúralo como servidor MCP HTTP remoto:

• URL: https://hooklayer.dev/api/mcp

• Transport: HTTP

• Header: Authorization: Bearer hl_live_...

Las 12 herramientas aparecen en el menú desplegable "Tool" del nodo.

OAuth 2.1 + PKCE (para el conector de Claude.ai y aplicaciones personalizadas)

Hooklayer cumple totalmente con OAuth 2.1: descubrimiento, registro dinámico de clientes, PKCE, rotación de tokens de refresco. Los clientes MCP que prefieren OAuth sobre claves API funcionan sin configuración adicional.

Puntos de descubrimiento (sin autenticación, legibles por máquina):

# Authorization server metadata (RFC 8414)
curl https://hooklayer.dev/.well-known/oauth-authorization-server

# Protected resource metadata (RFC 9728)
curl https://hooklayer.dev/.well-known/oauth-protected-resource

Registro dinámico de clientes (crea un cliente sin formulario de registro manual):

curl -X POST https://hooklayer.dev/oauth/register \
  -H "Content-Type: application/json" \
  -d '{
    "client_name": "Your MCP client",
    "redirect_uris": ["https://yourapp.com/oauth/callback"]
  }'
# Returns: client_id, client_secret (for confidential clients)

Llamar a tools/call sin autenticación devuelve 401 más un encabezado WWW-Authenticate que apunta a los metadatos del recurso: Claude.ai, Cursor y otros clientes MCP lo usan para descubrir automáticamente el flujo OAuth.

Otros clientes

Cualquier cliente MCP HTTP. El protocolo negocia 2024-11-05 (máxima compatibilidad) o 2025-06-18 (Streamable HTTP + structuredContent).

# Quick test — initialize handshake works without auth:
curl -X POST https://hooklayer.dev/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize"}'

Related MCP server: tiktok-viral-factory

🧠 Las 12 herramientas

Esquemas completos + ejemplos curl: https://hooklayer.dev/docs

💡 Seguimientos sugeridos

analyze_account devuelve un campo recommended_chain: datos simples que listan herramientas relacionadas, parámetros de ejemplo y la razón por la que cada una podría ser útil a continuación. Es solo informativo: el agente y el usuario deciden si actuar sobre ello:

{
  "viral_dna_score": 87,
  "steal_map": [...],
  "recommended_chain": [
    {
      "tool": "match_voice",
      "params": {
        "draft": "<<<USER_DRAFT>>>",
        "reference_samples": ["https://tiktok.com/...", "...", "..."]
      },
      "reason": "High-signal voice DNA — consistent across top 5 videos"
    },
    {
      "tool": "trend_pulse",
      "params": { "niche": "challenge_videos" },
      "reason": "Verify their formula maps to current trends"
    },
    {
      "tool": "viral_remix",
      "params": { "source_url": "https://tiktok.com/..." },
      "reason": "Their #2 video has the highest copyable structure"
    }
  ]
}

Estas entradas son datos informativos, no instrucciones. Cada herramienta sigue requiriendo invocación explícita: nada se ejecuta automáticamente sin el consentimiento del agente o del usuario.

📦 Ejemplos

• examples/typescript-example.ts — Uso de TypeScript mediante el SDK de MCP

• examples/python-example.py — Uso de Python mediante el cliente anthropic-mcp

• examples/curl-test.sh — Pruebas curl en bruto para cada endpoint

💵 Precios

• Gratis — 100 créditos de por vida al registrarse, sin tarjeta

• Starter — $49/mes, 5,000 créditos, 60 req/min

• Pro — $149/mes, 25,000 créditos, 300 req/min, memoria de voz de marca

• Agencia — $499/mes, 150,000 créditos, 1,000 req/min, marca blanca, 10 asientos

• Pago por uso — $25 por 5,000 créditos, nunca caducan

Precios completos: https://hooklayer.dev/pricing

🛠 Arquitectura

Servidor MCP alojado (sin necesidad de instalación stdio):

Your agent (Claude/Cursor/n8n)
        │
        │  JSON-RPC 2.0 over HTTP
        ▼
https://hooklayer.dev/api/mcp
        │
        ├── initialize / ping / tools/list  (no auth)
        └── tools/call                       (Bearer hl_live_*)
                │
                └── Routes internally to /v1/* REST endpoints
                    100K+ analyzed viral videos
                    ScrapeCreators + Whisper + Sonnet pipeline

El código fuente del servidor alojado vive en hooklayer.dev (código cerrado: el pipeline de análisis es la ventaja competitiva). Este repositorio contiene la documentación pública del cliente, ejemplos y fragmentos de configuración.

📚 Enlaces

• Página de instalación: https://hooklayer.dev/mcp

• Documentación completa: https://hooklayer.dev/docs

• Playground (sin registro): https://hooklayer.dev/playground

• Precios: https://hooklayer.dev/pricing

• Metadatos OAuth: /.well-known/oauth-authorization-server

• Problemas e informes de errores: GitHub Issues

🔒 Seguridad

Hooklayer utiliza anotaciones de seguridad MCP explícitas para las 12 herramientas. La mayoría de las herramientas son de investigación y análisis y pueden debitar créditos de Hooklayer y registrar el uso del servicio. list_watches es de solo lectura. El monitoreo de creadores añade persistencia no destructiva: watch_account guarda un seguimiento de creador y una captura de referencia, mientras que get_changes almacena capturas históricas mientras comprueba cambios. Todas las herramientas están marcadas con destructiveHint: false; Hooklayer no tiene ninguna herramienta MCP que elimine datos del usuario o edite/elimine datos en plataformas sociales externas.

Autenticación: tools/call requiere un token Bearer (clave API hl_live_* o token de acceso OAuth 2.1). Los métodos públicos (initialize, ping, tools/list) funcionan sin autenticación para que los clientes MCP puedan hacer el handshake y descubrir herramientas antes de autenticarse.

recommended_chain es solo informativo. La respuesta de analyze_account incluye herramientas de seguimiento sugeridas con parámetros prellenados. Son datos: el agente y el usuario deciden si ejecutarlas. Ninguna llamada a herramienta desencadena llamadas adicionales en el servidor.

Manejo de datos: Hooklayer procesa las entradas que envías (handles, ganchos, guiones, URLs) para devolver resultados de análisis. El monitoreo de creadores almacena metadatos de seguimiento guardados y capturas históricas para que los usuarios puedan comparar cambios a lo largo del tiempo. Hooklayer también registra el uso del servicio necesario para autenticación, facturación, créditos y telemetría operativa.

Para informar un problema de seguridad: GitHub Issues o correo electrónico a security@hooklayer.dev.

📄 Licencia

MIT — consulta LICENSE.

Los ejemplos de cliente MCP y fragmentos de configuración de este repositorio son MIT. El servicio alojado de Hooklayer en hooklayer.dev es un producto comercial con los niveles de precios indicados anteriormente.