Hooklayer

MCP de inteligencia en vivo de creadores de TikTok — 7 herramientas (analizar creadores, puntuar ganchos, remezclar guiones, predecir viralidad) que se encadenan automáticamente mediante una recommended_chain que rellena previamente las siguientes 3 llamadas a herramientas.

Documentación

Hooklayer MCP

License: MIT npm version Version MCP Production Tools OAuth smithery badge

Inteligencia de contenido viral para agentes de IA. Integra el servidor MCP de Hooklayer en Claude Desktop, Cursor, n8n o cualquier cliente HTTP MCP 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 hooks, remezcla videos virales, replica la voz de un creador, predice la viralidad de un borrador, convierte un brief de marca en un blueprint 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. Dos formas de instalarlo:

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

En la interfaz web/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 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 de hl_live_ en https://hooklayer.dev/auth/signup — 100 créditos de por vida, sin tarjeta requerida.

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
  • Transporte: HTTP
  • Cabecera: 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 + 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.

Endpoints de descubrimiento (sin autenticación requerida, 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)

Acceder a tools/call sin autenticación devuelve 401 más una cabecera WWW-Authenticate que apunta a los metadatos del recurso — Claude.ai, Cursor y otros clientes MCP lo usan para auto-descubrir el flujo OAuth.

Otros clientes

Cualquier cliente HTTP MCP. 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"}'

🧠 Las 12 herramientas

HerramientaCréditosQué hace
analyze_account5Análisis profundo de creador (TikTok, YouTube, Instagram): puntuaciones de ADN viral, huella de formato, mejores videos con transcripciones, brechas de contenido, insight de titulares y próximos pasos de investigación sugeridos.
search_videos1Búsqueda por palabra clave en TikTok o Instagram — hasta 20 videos clasificados por engagement, con filtros por nicho, vistas, actualidad y región.
score_hook1Puntúa cualquier hook de 0 a 100 según patrones virales probados. Devuelve 3 reescrituras de mayor calidad.
viral_remix3URL o transcripción → guion nuevo con ADN viral espejado. Escena por escena con tomas de cámara.
trend_pulse1Oportunidades emergentes en tiempo real + patrones saturados por nicho. Caché de 12 horas.
find_viral_template1Plantillas clasificadas por ajuste al nicho con patrones de hook + URLs de ejemplo.
match_voice2Extrae el ADN de voz de un creador a partir de 3+ muestras, reescribe un borrador en su estilo.
predict_virality2Puntúa un guion borrador por potencial viral antes de publicar. Diagnóstico de retención.
brief_to_blueprint7Brief de marca → blueprint creativo de una página: hook, plantilla, hashtags, verificación de velocidad de tendencia e instrucciones de grabación en una sola llamada.
watch_account0 o 5Guarda un seguimiento de creador y una captura base. Reutiliza un análisis compatible reciente a 0 créditos cuando está disponible; de lo contrario, ejecuta un análisis nuevo de 5 créditos.
list_watches0Lista los seguimientos de creadores guardados del usuario autenticado y metadatos de seguimiento compactos.
get_changes5Ejecuta un análisis nuevo contra un seguimiento guardado, compara con la captura anterior, almacena una nueva captura histórica y devuelve cambios significativos más una acción opcional sugerida.

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


💡 Seguimientos sugeridos

analyze_account devuelve un campo recommended_chain: datos planos 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/usuario.


📦 Ejemplos

  • examples/typescript-example.ts — Uso en TypeScript mediante el SDK de MCP
  • examples/python-example.py — Uso en Python mediante el cliente anthropic-mcp
  • examples/curl-test.sh — Pruebas curl crudas para cada endpoint

💵 Precios

  • Gratis — 100 créditos de por vida al registrarte, 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 para clientes, ejemplos y fragmentos de configuración.


📚 Enlaces


🔒 Seguridad

Hooklayer usa 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 base, mientras que get_changes almacena capturas históricas mientras verifica cambios. Todas las herramientas están marcadas como destructiveHint: false; Hooklayer no tiene ninguna herramienta MCP que elimine datos de 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 lado del servidor.

Manejo de datos: Hooklayer procesa las entradas que envías (handles, hooks, guiones, URLs) para devolver resultados de análisis. El monitoreo de creadores almacena metadatos de seguimientos 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 reportar un problema de seguridad: GitHub Issues o correo a security@hooklayer.dev.


📄 Licencia

MIT — consulta LICENSE.

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