Hooklayer MCP

Viral-Content-Intelligenz für KI-Agenten. Setzen Sie den Hooklayer-MCP-Server in Claude Desktop, Cursor, n8n oder einen beliebigen HTTP-MCP-Client ein und Ihr Agent erhält 12 Tools für Kurzform-Content auf TikTok, Instagram und YouTube: Creator analysieren, Videos nach Stichwort suchen, virale Vorlagen und aufkommende Trends finden, Hooks bewerten und umschreiben, virale Videos remixen, die Stimme eines Creators nachahmen, das virale Potenzial eines Entwurfs vorhersagen, ein Marken-Briefing in einen drehfertigen kreativen Bauplan verwandeln und Creator im Laufe der Zeit mit gespeicherten Beobachtungen und historischen Schnappschüssen überwachen.

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

v1.1.0 (2026-05-14): Die Evidenzschicht ist da. Jede Bewertung enthält signals[] mit zitierten Belegen, ein would_fail_because-Gegenfaktum und ein quality-Gesundheitsfeld. predict_virality führt eine unabhängige adversariale Prüfung durch. Die Schritte von analyze_account.recommended_chain legen jetzt confidence, cost, action_class (Autoritäts-Taxonomie) und expected_output offen. Siehe CHANGELOG.md für die vollständige Veröffentlichung.

🚀 Schnellinstallation

Claude Desktop

Claude Desktop unterstützt keine nativen Remote-HTTP-MCP-Server – es benötigt die mcp-remote-Brücke. Es gibt zwei Installationsmöglichkeiten:

Option 1 – Custom Connector (am einfachsten, keine Konfigurationsdatei-Änderung)

In der Web-/Desktop-Oberfläche von Claude: Einstellungen → Connectors → Benutzerdefinierten Connector hinzufügen → diese URL einfügen:

https://hooklayer.dev/api/mcp

Claude.ai führt Sie durch OAuth (kein manuelles Einfügen von Schlüsseln). Fertig.

Option 2 – Direkte Konfiguration (für Power-User, die hl_live_-Schlüssel-Authentifizierung wünschen)

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

Holen Sie sich Ihren kostenlosen hl_live_-Schlüssel unter https://hooklayer.dev/auth/signup – 100 lebenslange Credits, keine Karte erforderlich.

Starten Sie Claude Desktop neu. Die 12 Hooklayer-Tools erscheinen in der 🔌-Connector-Liste.

Cursor

~/.cursor/mcp.json:

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

n8n

Fügen Sie in Ihrem Workflow einen MCP-Client-Knoten hinzu und konfigurieren Sie ihn als Remote-HTTP-MCP-Server:

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

• Transport: HTTP

• Header: Authorization: Bearer hl_live_...

Alle 12 Tools erscheinen im Dropdown-Menü „Tool“ des Knotens.

OAuth 2.1 + PKCE (für Claude.ai-Connector und benutzerdefinierte Apps)

Hooklayer ist vollständig OAuth-2.1-konform – Discovery, Dynamic Client Registration, PKCE, Refresh-Token-Rotation. MCP-Clients, die OAuth gegenüber API-Schlüsseln bevorzugen, funktionieren sofort.

Discovery-Endpunkte (keine Authentifizierung erforderlich, maschinenlesbar):

# 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 (Client ohne manuelles Anmeldeformular erstellen):

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)

Ein Aufruf von tools/call ohne Authentifizierung gibt 401 plus einen WWW-Authenticate-Header zurück, der auf die Ressourcen-Metadaten verweist – Claude.ai, Cursor und andere MCP-Clients nutzen dies, um den OAuth-Ablauf automatisch zu erkennen.

Andere Clients

Jeder HTTP-MCP-Client. Das Protokoll verhandelt 2024-11-05 (breiteste Kompatibilität) oder 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: 自媒体文案助手 MCP Server

🧠 Die 12 Tools

Vollständige Schemas + curl-Beispiele: https://hooklayer.dev/docs

💡 Vorgeschlagene Folgeaktionen

analyze_account gibt ein recommended_chain-Feld zurück: einfache Daten, die verwandte Tools, Beispielparameter und den Grund, warum jedes als Nächstes nützlich sein könnte, auflisten. Es ist nur beratend – der Agent und der Benutzer entscheiden, ob sie darauf reagieren:

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

Diese Einträge sind Informationsdaten, keine Anweisungen. Jedes Tool erfordert weiterhin einen expliziten Aufruf – nichts läuft automatisch ohne Zustimmung von Agent/Benutzer.

📦 Beispiele

• examples/typescript-example.ts – TypeScript-Nutzung über das MCP-SDK

• examples/python-example.py – Python-Nutzung über den anthropic-mcp-Client

• examples/curl-test.sh – Rohe curl-Tests für jeden Endpunkt

💵 Preise

• Kostenlos – 100 lebenslange Credits bei der Anmeldung, keine Karte

• Starter – 49 $/Monat, 5.000 Credits, 60 Anfragen/min

• Pro – 149 $/Monat, 25.000 Credits, 300 Anfragen/min, Markenstimmen-Gedächtnis

• Agentur – 499 $/Monat, 150.000 Credits, 1.000 Anfragen/min, White-Label, 10 Plätze

• Pay-as-you-go – 25 $ für 5.000 Credits, verfallen nie

Vollständige Preise: https://hooklayer.dev/pricing

🛠 Architektur

Gehosteter MCP-Server (keine stdio-Installation erforderlich):

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

Der Quellcode für den gehosteten Server liegt unter hooklayer.dev (Closed Source – die Analyse-Pipeline ist der Burggraben). Dieses Repository enthält die öffentlichen Client-Dokumente, Beispiele und Konfigurationsausschnitte.

📚 Links

• Installationsseite: https://hooklayer.dev/mcp

• Vollständige Dokumentation: https://hooklayer.dev/docs

• Playground (ohne Anmeldung): https://hooklayer.dev/playground

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

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

• Probleme + Fehlerberichte: GitHub Issues

🔒 Sicherheit

Hooklayer verwendet explizite MCP-Sicherheitsannotationen für alle 12 Tools. Die meisten Tools sind Forschungs- und Analysetools, die Hooklayer-Credits abbuchen und die Servicenutzung aufzeichnen können. list_watches ist schreibgeschützt. Die Creator-Überwachung fügt nicht-destruktive Persistenz hinzu: watch_account speichert eine Creator-Beobachtung und einen Basis-Schnappschuss, während get_changes historische Schnappschüsse speichert, während es nach Änderungen sucht. Alle Tools sind mit destructiveHint: false markiert; Hooklayer hat kein MCP-Tool, das Benutzerdaten löscht oder Daten auf externen sozialen Plattformen bearbeitet/löscht.

Authentifizierung: tools/call erfordert ein Bearer-Token (hl_live_*-API-Schlüssel oder OAuth-2.1-Zugriffstoken). Öffentliche Methoden (initialize, ping, tools/list) funktionieren ohne Authentifizierung, damit MCP-Clients vor der Authentifizierung einen Handshake durchführen und Tools entdecken können.

recommended_chain ist nur beratend. Die analyze_account-Antwort enthält vorgeschlagene Folge-Tools mit vorausgefüllten Parametern. Dies sind Daten – der Agent und der Benutzer entscheiden, ob sie ausgeführt werden. Kein Tool-Aufruf löst jemals zusätzliche Tool-Aufrufe serverseitig aus.

Datenverarbeitung: Hooklayer verarbeitet die von Ihnen gesendeten Eingaben (Handles, Hooks, Skripte, URLs), um Analyseergebnisse zurückzugeben. Die Creator-Überwachung speichert gespeicherte Beobachtungs-Metadaten und historische Schnappschüsse, damit Benutzer Änderungen im Laufe der Zeit vergleichen können. Hooklayer zeichnet außerdem die Servicenutzung auf, die für Authentifizierung, Abrechnung, Credits und Betriebstelemetrie erforderlich ist.

Um ein Sicherheitsproblem zu melden: GitHub Issues oder E-Mail an security@hooklayer.dev.

📄 Lizenz

MIT – siehe LICENSE.

Die MCP-Client-Beispiele und Konfigurationsausschnitte in diesem Repository sind MIT-lizenziert. Der gehostete Hooklayer-Dienst unter hooklayer.dev ist ein kommerzielles Produkt mit den oben aufgeführten Preisstufen.