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. Adicione o servidor MCP da Hooklayer ao Claude Desktop, Cursor, n8n ou qualquer cliente HTTP MCP e seu agente ganha 12 ferramentas para conteúdo de formato curto no TikTok, Instagram e YouTube: analise criadores, pesquise vídeos por palavra-chave, encontre templates virais e tendências em alta, pontue e reescreva hooks, remixe vídeos virais, combine com a voz de um criador, preveja a viralidade de um rascunho, transforme um briefing de marca em um blueprint criativo pronto para gravação e monitore criadores ao longo do tempo com watchlists salvas e snapshots históricos.

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

v1.1.0 (2026-05-14): A camada de evidências chegou. 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 de analyze_account.recommended_chain agora expõem confidence, cost, action_class (taxonomia de autoridade) e expected_output. Consulte CHANGELOG.md para o lançamento completo.

🚀 Instalação rápida

Claude Desktop

O Claude Desktop não suporta nativamente servidores MCP HTTP remotos — ele precisa da ponte mcp-remote. Duas formas 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 necessidade de 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 hl_live_ gratuita em https://hooklayer.dev/auth/signup — 100 créditos vitalícios, sem necessidade de cartão.

Reinicie o Claude Desktop. As 12 ferramentas da 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 workflow, adicione um nó MCP Client e configure como servidor MCP HTTP remoto:

URL: https://hooklayer.dev/api/mcp
Transporte: HTTP
Cabeçalho: Authorization: Bearer hl_live_...

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

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

A Hooklayer é totalmente compatível com OAuth 2.1 — descoberta, Dynamic Client Registration, PKCE, rotação de refresh tokens. Clientes MCP que preferem OAuth em vez de chaves de API funcionam de imediato.

Endpoints de descoberta (sem autenticação, 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

Dynamic Client Registration (crie um cliente sem formulário manual de cadastro):

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 além de 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 12 ferramentas

Ferramenta	Créditos	O que faz
`analyze_account`	5	Análise aprofundada de criador (TikTok, YouTube, Instagram): pontuações de DNA viral, impressão digital de formato, principais vídeos com transcrições, lacunas de conteúdo, insights de manchetes e próximos passos de pesquisa sugeridos.
`search_videos`	1	Pesquisa por palavra-chave no TikTok ou Instagram — até 20 vídeos ranqueados por engajamento, com filtros por nicho, visualizações, recência e região.
`score_hook`	1	Pontue qualquer hook 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 enquadramentos 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	Templates ranqueados por adequação ao nicho com padrões de hook + URLs de exemplo.
`match_voice`	2	Extraia o DNA de 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: hook, template, hashtags, verificação de velocidade de tendência e instruções de gravação em uma única chamada.
`watch_account`	0 ou 5	Salve um watch de criador e snapshot de linha de base. Reutiliza uma análise recente compatível a 0 créditos quando disponível; caso contrário, executa uma nova análise de 5 créditos.
`list_watches`	0	Liste os watches de criadores salvos do usuário autenticado e metadados compactos de rastreamento.
`get_changes`	5	Execute uma nova análise contra um watch salvo, compare com o snapshot anterior, armazene um novo snapshot histórico e retorne mudanças relevantes além de uma próxima ação opcional.

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

💡 Acompanhamentos sugeridos

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 agem 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 exige invocação explícita — nada é executado automaticamente sem 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

Grátis — 100 créditos vitalícios no cadastro, sem cartão
Starter — US$ 49/mês, 5.000 créditos, 60 req/min
Pro — US$ 149/mês, 25.000 créditos, 300 req/min, memória de voz de marca
Agência — US$ 499/mês, 150.000 créditos, 1.000 req/min, white-label, 10 assentos
Pré-pago — US$ 25 por 5.000 créditos, sem expiração

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

🛠 Arquitetura

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

A Hooklayer usa anotações explícitas de segurança MCP para todas as 12 ferramentas. A maioria das ferramentas são de pesquisa e análise e podem debitar créditos da Hooklayer e registrar o uso do serviço. list_watches é somente leitura. O monitoramento de criadores adiciona persistência não destrutiva: watch_account salva um watch de criador e snapshot de linha de base, enquanto get_changes armazena snapshots históricos ao verificar mudanças. Todas as ferramentas são marcadas como destructiveHint: false; a Hooklayer não possui ferramenta MCP que exclua dados do usuário ou edite/exclua dados em plataformas sociais externas.

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 de analyze_account inclui ferramentas de acompanhamento sugeridas com parâmetros pré-preenchidos. São dados — o agente e o usuário decidem se executam. Nenhuma chamada de ferramenta aciona chamadas adicionais no lado do servidor.

Tratamento de dados: A Hooklayer processa as entradas que você envia (handles, hooks, roteiros, URLs) para retornar resultados de análise. O monitoramento de criadores armazena metadados de watch salvos e snapshots históricos para que usuários possam comparar mudanças ao longo do tempo. A Hooklayer também registra o uso do serviço necessário para autenticação, cobrança, créditos e telemetria operacional.

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

📄 Licença

MIT — consulte LICENSE.

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