Hooklayer

by khan-ashifur

354 downloads

Not rated

GitHub

About

Live TikTok creator intelligence for AI agents. Hooklayer pulls real performance data from any TikTok handle in seconds: viral DNA scoring, replicability analysis, top-performing video breakdowns, format fingerprints, hook patterns, and a stealable steal_map. 7 MCP tools that cha

Details

Author: khan-ashifur
Downloads: 354
Categories: Marketing, Other, AI, Media

- Seven MCP tools for TikTok creator intelligence.
- Agentic chain pattern – analyze_account pre-fills the next three tool calls.
- Viral DNA scoring, replicability, originality, consistency metrics.
- Hook scoring and rewriting against proven viral patterns.
- Trend pulse for rising and saturated short-form video opportunities.
- Voice DNA extraction and script rewriting in a creator’s style.
- Virality prediction for draft scripts before recording.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Hooklayer

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

Install by editing claude_desktop_config.json to add Hooklayer as an MCP server using npx mcp-remote with a Bearer token. Obtain a free hl_live_ API key at https://hooklayer.dev/auth/signup (100 lifetime credits, no card required). The server exposes seven MCP tools; start with analyze_account which returns a recommended_chain pre-filling the next three tool calls for automatic chaining.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

Viral-content intelligence for AI agents.Drop the Hooklayer MCP server into Claude Desktop, Cursor, n8n, or any HTTP MCP client and your agent gets 9 read-only tools for short-form content across TikTok, Instagram, and YouTube: analyze creators, search videos by keyword, find viral templates and rising trends, score and rewrite hooks, remix viral videos, match a creator's voice, predict a draft's virality, and turn a brand brief into a shoot-ready creative blueprint.

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

v1.1.0 (2026-05-14):The evidence layer ships. Every score includessignals[]with cited evidence, awould_fail_becausecounterfactual, and aqualityhealth field.predict_viralityruns an independent adversarial check.analyze_account.recommended_chainsteps now exposeconfidence,cost,action_class(authority taxonomy), andexpected_output. SeeCHANGELOG.mdfor the full ship.

Claude Desktop doesn't natively support remote HTTP MCP servers — it needs the mcp-remotebridge. Two ways to install:

Option 1 — Custom Connector (easiest, no config file edit)

In Claude's web/desktop UI:Settings → Connectors → Add custom connector → paste this URL:

Claude.ai will walk you through OAuth (no manual key paste). Done.

Option 2 — Direct config (for power users who wanthl_live_key auth)

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

Get your freehl_live_key athttps://hooklayer.dev/auth/signup— 100 lifetime credits, no card required.

Restart Claude Desktop. The 9 Hooklayer tools appear in the 🔌 connector list.

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

In your workflow, add anMCP Clientnode and configure as a remote HTTP MCP server:

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

All 9 tools appear in the node's "Tool" dropdown.

OAuth 2.1 + PKCE (for Claude.ai connector + custom apps)

Hooklayer is fully OAuth 2.1 compliant — discovery, Dynamic Client Registration, PKCE, refresh token rotation. MCP clients that prefer OAuth over API keys work out of the box.

Discovery endpoints (no auth required, machine-readable):

# 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 (create a client without a manual signup form):

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)

Hittingtools/callwithout auth returns401plus aWWW-Authenticateheader pointing at the resource metadata — Claude.ai, Cursor, and other MCP clients use this to auto-discover the OAuth flow.

Any HTTP MCP client. Protocol negotiates2024-11-05(broadest compat) or2025-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"}'

Full schemas + curl examples:https://hooklayer.dev/docs

analyze_accountreturns arecommended_chainfield: plain data listing related tools, example parameters, and the reason each might be useful next. It is advisory only — the agent and user decide whether to act on it:

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

These entries are informational data, not instructions. Each tool still requires explicit invocation — nothing runs automatically without agent/user consent.

- examples/typescript-example.ts— TypeScript usage via the MCP SDK
- examples/python-example.py— Python usage viaanthropic-mcpclient
- examples/curl-test.sh— Raw curl tests for every endpoint

- Free— 100 lifetime credits at signup, no card
- Starter— $49/month, 5,000 credits, 60 req/min
- Pro— $149/month, 25,000 credits, 300 req/min, brand voice memory
- Agency— $499/month, 150,000 credits, 1,000 req/min, white-label, 10 seats
- Pay-as-you-go— $25 for 5,000 credits, never expire

Full pricing:https://hooklayer.dev/pricing

Hosted MCP server (no stdio install needed):

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

Source code for the hosted server lives athooklayer.dev(closed source — the analysis pipeline is the moat). This repo holds the public client docs, examples, and config snippets.

- Install page:https://hooklayer.dev/mcp
- Full docs:https://hooklayer.dev/docs
- Playground (no signup):https://hooklayer.dev/playground
- Pricing:https://hooklayer.dev/pricing
- OAuth metadata:/.well-known/oauth-authorization-server
- Issues + bug reports:GitHub Issues

All 9 tools are read-only.They analyze, score, and generate content — none of them create, modify, or delete any user data, accounts, or external resources. Every tool carriesreadOnlyHint: trueanddestructiveHint: falsein its MCP annotations.

Authentication:tools/callrequires a Bearer token (hl_live_*API key or OAuth 2.1 access token). Public methods (initialize,ping,tools/list) work without auth so MCP clients can handshake and discover tools before authentication.

recommended_chainis advisory only.Theanalyze_accountresponse includes suggested follow-up tools with pre-filled parameters. These are data — the agent and user decide whether to execute them. No tool call ever triggers additional tool calls server-side.

Data handling:Hooklayer processes the inputs you send (handles, hooks, scripts, URLs) to return analysis results. We do not store your content beyond the request lifecycle except for anonymous usage metrics.

To report a security issue:GitHub Issuesor email security@hooklayer.dev.

The MCP client examples and config snippets in this repo are MIT. The hosted Hooklayer service athooklayer.devis a commercial product with the pricing tiers listed above.

Free MCP that drives an audit of your marketing. Your AI connects, adsOS digs through your ads, email and site, and hands back a growth plan you can run today.

Publish, schedule, moderate your social inbox, and pull analytics across every major network directly from any AI assistant, via Eclincher.

Instagram Graph API server for Business/Creator accounts — 24 tools for posting, comments, DMs, and insights.

Connect Claude or ChatGPT to your LinkedIn account to see who engaged on your posts, track performance and profile viewers, spot warm outreach signals, and publish content — built for B2B marketers and creators.

A hosted MCP server for planning, scheduling, media, analytics, and social publishing.

AI first social listening tool with MCP support

AI-first blogging platform: publish articles, save drafts, generate titles, research topics, and get analytics via MCP.

Turn short-video comments into ranked customer leads, keyword ideas, and outreach scripts.

Create and manage AI-powered short-form social content, including avatars, product scenes, videos, slideshows, scheduling, and publishing.

Editorial intelligence for creators and their agents — discover the stories worth writing about, rank the strongest angle, and draft grounded, platform-native posts.

Accurately count Twitter/X post characters and optimize posts.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

OAuth 2.1 + PKCE (for Claude.ai connector + custom apps)

Install

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive

Context 7

Reactive Resume