Hooklayer

MCP de inteligência ao vivo para criadores do TikTok — 7 ferramentas (analisar criadores, pontuar ganchos, remixar roteiros, prever viralidade) que se encadeiam automaticamente por meio de uma recommended_chain que pré-preenche as próximas 3 chamadas de ferramenta.

GitHubExperimente este MCPPatrocinado

Documentação

Hooklayer MCP

Inteligência de conteúdo viral para agentes de IA. Coloque o servidor Hooklayer MCP no Claude Desktop, Cursor, n8n ou qualquer cliente HTTP MCP e seu agente obtém 9 ferramentas somente leitura para conteúdo de formato curto no TikTok, Instagram e YouTube: analise criadores, pesquise vídeos por palavra-chave, encontre modelos virais e tendências em alta, pontue e reescreva ganchos, remixe vídeos virais, combine a voz de um criador, preveja a viralidade de um rascunho e transforme um briefing de marca em um blueprint criativo pronto para gravação.

9 read-only tools · all return structured JSON · no mutations · no side effects

v1.1.0 (2026-05-14): A camada de evidências chega. Cada pontuação inclui signals[] com evidências citadas, um contrafactual would_fail_because e um campo de saúde quality. predict_virality executa uma verificação adversarial independente. As etapas analyze_account.recommended_chain agora expõem confidence, cost, action_class (taxonomia de autoridade) e expected_output. Veja CHANGELOG.md para o lançamento completo.

🚀 Instalação rápida

Claude Desktop

O Claude Desktop não suporta nativamente servidores HTTP MCP remotos — ele precisa da ponte mcp-remote. Duas maneiras de instalar:

Opção 1 — Conector Personalizado (mais fácil, sem editar arquivo de configuração)

Na interface web/desktop do Claude: Configurações → Conectores → Adicionar conector personalizado → cole esta URL:

https://hooklayer.dev/api/mcp

O Claude.ai vai te guiar pelo OAuth (sem colar chave manualmente). Pronto.

Opção 2 — Configuração direta (para usuários avançados que querem autenticação por chave hl_live_)

Edite 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_..."
      ]
    }
  }
}

Obtenha sua chave gratuita hl_live_ em https://hooklayer.dev/auth/signup — 100 créditos vitalícios, sem cartão de crédito.

Reinicie o Claude Desktop. As 9 ferramentas Hooklayer aparecem na lista de conectores 🔌.

Cursor

~/.cursor/mcp.json:

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

n8n

No seu fluxo de trabalho, adicione um nó MCP Client e configure como um servidor HTTP MCP remoto:

URL: https://hooklayer.dev/api/mcp
Transport: HTTP
Header: Authorization: Bearer hl_live_...

Todas as 9 ferramentas aparecem no menu suspenso "Tool" do nó.

OAuth 2.1 + PKCE (para conector Claude.ai + aplicativos personalizados)

O Hooklayer é totalmente compatível com OAuth 2.1 — descoberta, Registro Dinâmico de Cliente, PKCE, rotação de token de atualização. Clientes MCP que preferem OAuth em vez de chaves de API funcionam imediatamente.

Endpoints de descoberta (sem autenticação necessária, legíveis 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 Cliente (crie um cliente sem formulário manual de inscrição):

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)

Acessar tools/call sem autenticação retorna 401 mais um cabeçalho WWW-Authenticate apontando para os metadados do recurso — Claude.ai, Cursor e outros clientes MCP usam isso para descobrir automaticamente o fluxo OAuth.

Outros clientes

Qualquer cliente HTTP MCP. O protocolo negocia 2024-11-05 (maior compatibilidade) ou 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"}'

🧠 As 9 ferramentas

Ferramenta	Créditos	O que faz
`analyze_account`	5	Mergulho profundo no criador (TikTok, YouTube, Instagram): pontuações de DNA viral, impressão digital do formato, principais vídeos com transcrições, lacunas de conteúdo, insight de manchete e próximos passos de pesquisa sugeridos.
`search_videos`	1	Pesquisa por palavra-chave no TikTok ou Instagram — até 20 vídeos classificados por engajamento, com filtros por nicho, visualizações, recência e região.
`score_hook`	1	Pontue qualquer gancho de 0 a 100 com base em padrões virais comprovados. Retorna 3 reescritas com qualidade superior.
`viral_remix`	3	URL ou transcrição → roteiro novo com DNA viral espelhado. Cena a cena com planos de câmera.
`trend_pulse`	1	Oportunidades em alta em tempo real + padrões saturados por nicho. Cache de 12 horas.
`find_viral_template`	1	Modelos classificados por adequação ao nicho com padrões de gancho + URLs de exemplo.
`match_voice`	2	Extraia o DNA da voz de um criador a partir de 3+ amostras, reescreva um rascunho no estilo dele.
`predict_virality`	2	Pontue um roteiro rascunho quanto ao potencial viral antes de publicar. Diagnóstico de retenção.
`brief_to_blueprint`	7	Briefing de marca → blueprint criativo de uma página: gancho, modelo, hashtags, verificação de velocidade de tendência e instruções de gravação em uma única chamada.

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

💡 Sugestões de acompanhamento

analyze_account retorna um campo recommended_chain: dados simples listando ferramentas relacionadas, parâmetros de exemplo e o motivo pelo qual cada uma pode ser útil em seguida. É apenas consultivo — o agente e o usuário decidem se devem agir com base nisso:

{
  "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"
    }
  ]
}

Essas entradas são dados informativos, não instruções. Cada ferramenta ainda requer invocação explícita — nada é executado automaticamente sem o consentimento do agente/usuário.

📦 Exemplos

examples/typescript-example.ts — uso em TypeScript via SDK MCP
examples/python-example.py — uso em Python via cliente anthropic-mcp
examples/curl-test.sh — testes curl brutos para cada endpoint

💵 Preços

Free — 100 créditos vitalícios no cadastro, sem cartão
Starter — $49/mês, 5.000 créditos, 60 req/min
Pro — $149/mês, 25.000 créditos, 300 req/min, memória de voz da marca
Agency — $499/mês, 150.000 créditos, 1.000 req/min, white-label, 10 assentos
Pay-as-you-go — $25 por 5.000 créditos, nunca expiram

Preços completos: https://hooklayer.dev/pricing

🛠 Arquitetura

Servidor MCP hospedado (sem necessidade de instalação 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

O código-fonte do servidor hospedado está em hooklayer.dev (código fechado — o pipeline de análise é o diferencial). Este repositório contém a documentação pública do cliente, exemplos e trechos de configuração.

📚 Links

Página de instalação: https://hooklayer.dev/mcp
Documentação completa: https://hooklayer.dev/docs
Playground (sem cadastro): https://hooklayer.dev/playground
Preços: https://hooklayer.dev/pricing
Metadados OAuth: /.well-known/oauth-authorization-server
Problemas + relatórios de bugs: GitHub Issues

🔒 Segurança

Todas as 9 ferramentas são somente leitura. Elas analisam, pontuam e geram conteúdo — nenhuma delas cria, modifica ou exclui dados de usuário, contas ou recursos externos. Cada ferramenta carrega readOnlyHint: true e destructiveHint: false em suas anotações MCP.

Autenticação: tools/call exige um token Bearer (chave de API hl_live_* ou token de acesso OAuth 2.1). Métodos públicos (initialize, ping, tools/list) funcionam sem autenticação para que clientes MCP possam fazer handshake e descobrir ferramentas antes da autenticação.

recommended_chain é apenas consultivo. A resposta analyze_account inclui ferramentas de acompanhamento sugeridas com parâmetros pré-preenchidos. São dados — o agente e o usuário decidem se devem executá-los. Nenhuma chamada de ferramenta aciona chamadas adicionais no servidor.

Tratamento de dados: O Hooklayer processa as entradas que você envia (handles, ganchos, roteiros, URLs) para retornar resultados de análise. Não armazenamos seu conteúdo além do ciclo de vida da solicitação, exceto métricas anônimas de uso.

Para relatar um problema de segurança: GitHub Issues ou e-mail security@hooklayer.dev.

📄 Licença

MIT — veja LICENSE.

Os exemplos de cliente MCP e trechos de configuração neste repositório são MIT. O serviço Hooklayer hospedado em hooklayer.dev é um produto comercial com os níveis de preço listados acima.