Hooklayer MCP server
Commit Aug 22, 2026Provides AI agents with viral content intelligence tools to analyze creators, search videos, score hooks, and predict content virality across social platforms.
Also known as khan-ashifur/hooklayer
- Stars
- 0
- Tools
- 12
- Downloads, 30 days
- —
- Latest version
- 1.1.0
- Last commit
- Aug 22, 2026
- License
- MIT
What is Hooklayer MCP?
Hooklayer provides AI agents with viral content intelligence tools to analyze creators, search videos, score hooks, and predict content virality across social platforms. It exposes 12 tools, such as analyze_account, search_videos, score_hook.
Summary generated from the project's README
About Hooklayer MCP server
Hooklayer provides viral content intelligence specifically designed for AI agents working with short-form video platforms like TikTok, Instagram, and YouTube. It offers a suite of 12 specialized tools that allow agents to perform deep creator analysis, search for trending videos, and score the effectiveness of content hooks. Developers can integrate this server into Claude Desktop, Cursor, or n8n using a remote HTTP connection.
Users can connect via OAuth 2.1 for a streamlined experience in Claude.ai or use a Bearer token for direct configuration in other clients. The server operates on a credit-based system, offering 100 lifetime credits for free upon signup. Beyond simple searches, the platform includes advanced capabilities like predicting the virality of a draft script, matching a specific creator's voice, and transforming brand briefs into complete creative blueprints. It is built to be non-destructive, meaning it monitors and analyzes social data without making any edits or deletions on external platforms.
What you can do with it
- 1Optimize video hooksHave an AI agent evaluate a hook and provide improved versions based on viral patterns.
- 2Generate creative blueprintsConvert a brand brief into a detailed plan including hooks, templates, and shoot instructions.
- 3Predict content successUse an agent to check if a draft script has the potential to go viral before you publish it.
Written from the project's README. Every use case is checked against a quote from it.
How to install Hooklayer MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Hooklayer MCP in Claude Code
$ claude mcp add --transport http hooklayer https://hooklayer.dev/api/mcpInstall Hooklayer MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"hooklayer": {
"url": "https://hooklayer.dev/api/mcp"
}
}
}Install Hooklayer MCP in VS Code
.vscode/mcp.json
{
"servers": {
"hooklayer": {
"type": "http",
"url": "https://hooklayer.dev/api/mcp"
}
}
}Install Hooklayer MCP in VS Code CLI
$ code --add-mcp '{"name":"hooklayer","type":"http","url":"https://hooklayer.dev/api/mcp"}'Install Hooklayer MCP in Codex
$ codex mcp add hooklayer --url https://hooklayer.dev/api/mcpInstall Hooklayer MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.hooklayer] url = "https://hooklayer.dev/api/mcp"
Install Hooklayer MCP in Gemini CLI
$ gemini mcp add -s user --transport http hooklayer https://hooklayer.dev/api/mcpInstall Hooklayer MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"hooklayer": {
"url": "https://hooklayer.dev/api/mcp",
"type": "http"
}
}
}Hooklayer MCP tools 12
Detected from the READMEanalyze_accountsearch_videosscore_hookviral_remixtrend_pulsefind_viral_templatematch_voicepredict_viralitybrief_to_blueprintwatch_accountlist_watchesget_changes
| analyze_account | — | |
| search_videos | — | |
| score_hook | — | |
| viral_remix | — | |
| trend_pulse | — | |
| find_viral_template | — | |
| match_voice | — | |
| predict_virality | — | |
| brief_to_blueprint | — | |
| watch_account | — | |
| list_watches | — | |
| get_changes | — |
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachablekhan-ashifur/hooklayer is public and reachablegithub.com/khan-ashifur/hooklayer ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-08-22github.com/khan-ashifur/hooklayer ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model12 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeinitialize answered with protocol 2025-06-18 in 366 msPass
README
View on GitHubHooklayer MCP
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 12 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, turn a brand brief into a shoot-ready creative blueprint, and monitor creators over time with saved watches and historical snapshots.
12 tools · structured JSON · non-destructive creator monitoring · no external social-platform edits or deletes
v1.1.0 (2026-05-14): The evidence layer ships. Every score includes
signals[]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. See CHANGELOG.md for the full ship.
🚀 Quick install
Claude Desktop
Claude Desktop doesn't natively support remote HTTP MCP servers — it needs the mcp-remote bridge. 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:
https://hooklayer.dev/api/mcp
Claude.ai will walk you through OAuth (no manual key paste). Done.
Option 2 — Direct config (for power users who want hl_live_ key auth)
Edit 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_..."
]
}
}
}
Get your free hl_live_ key at https://hooklayer.dev/auth/signup — 100 lifetime credits, no card required.
Restart Claude Desktop. The 12 Hooklayer tools appear in the 🔌 connector list.
Cursor
~/.cursor/mcp.json:
{
"mcpServers": {
"hooklayer": {
"url": "https://hooklayer.dev/api/mcp",
"transport": "http",
"headers": {
"Authorization": "Bearer hl_live_..."
}
}
}
}
n8n
In your workflow, add an MCP Client node and configure as a remote HTTP MCP server:
- URL:
https://hooklayer.dev/api/mcp - Transport:
HTTP - Header:
Authorization: Bearer hl_live_...
All 12 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)
Hitting tools/call without auth returns 401 plus a WWW-Authenticate header pointing at the resource metadata — Claude.ai, Cursor, and other MCP clients use this to auto-discover the OAuth flow.
Other clients
Any HTTP MCP client. Protocol negotiates 2024-11-05 (broadest compat) or 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"}'
🧠 The 12 tools
| Tool | Credits | What it does |
|---|---|---|
analyze_account |
5 | Creator deep dive (TikTok, YouTube, Instagram): viral DNA scores, format fingerprint, top videos with transcripts, content gaps, headline insight, and suggested next research steps. |
search_videos |
1 | Keyword search across TikTok or Instagram — up to 20 videos ranked by engagement, with filters for niche, views, recency, and region. |
score_hook |
1 | Score any hook 0-100 against proven viral patterns. Returns 3 rewrites at higher quality. |
viral_remix |
3 | URL or transcript → fresh script with mirrored viral DNA. Scene-by-scene with camera shots. |
trend_pulse |
1 | Real-time rising opportunities + saturated patterns per niche. 12-hour cache. |
find_viral_template |
1 | Niche-fit ranked templates with hook patterns + example URLs. |
match_voice |
2 | Extract a creator's voice DNA from 3+ samples, rewrite a draft in their style. |
predict_virality |
2 | Score a draft script for viral potential before publishing. Retention diagnosis. |
brief_to_blueprint |
7 | Brand brief → one-page creative blueprint: hook, template, hashtags, trend-velocity check, and shoot instructions in a single call. |
watch_account |
0 or 5 | Save a creator watch and baseline snapshot. Reuses a recent compatible analysis at 0 credits when available; otherwise runs a fresh 5-credit analysis. |
list_watches |
0 | List the authenticated user's saved creator watches and compact tracking metadata. |
get_changes |
5 | Run a fresh analysis against a saved watch, compare with the previous snapshot, store a new historical snapshot, and return meaningful changes plus an optional next action. |
Full schemas + curl examples: https://hooklayer.dev/docs
💡 Suggested follow-ups
analyze_account returns a recommended_chain field: 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
examples/typescript-example.ts— TypeScript usage via the MCP SDKexamples/python-example.py— Python usage viaanthropic-mcpclientexamples/curl-test.sh— Raw curl tests for every endpoint
💵 Pricing
- 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
🛠 Architecture
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 at hooklayer.dev (closed source — the analysis pipeline is the moat). This repo holds the public client docs, examples, and config snippets.
📚 Links
- 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
🔒 Security
Hooklayer uses explicit MCP safety annotations for all 12 tools. Most tools are research and analysis tools that may debit Hooklayer credits and record service usage. list_watches is read-only. Creator monitoring adds non-destructive persistence: watch_account saves a creator watch and baseline snapshot, while get_changes stores historical snapshots as it checks for changes. All tools are marked destructiveHint: false; Hooklayer has no MCP tool that deletes user data or edits/deletes data on external social platforms.
Authentication: tools/call requires 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_chain is advisory only. The analyze_account response 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. Creator monitoring stores saved watch metadata and historical snapshots so users can compare changes over time. Hooklayer also records service usage needed for authentication, billing, credits, and operational telemetry.
To report a security issue: GitHub Issues or email security@hooklayer.dev.
📄 License
MIT — see LICENSE.
The MCP client examples and config snippets in this repo are MIT. The hosted Hooklayer service at hooklayer.dev is a commercial product with the pricing tiers listed above.
Hooklayer MCP questions
How do I add Hooklayer MCP to Claude Code?
Run claude mcp add --transport http hooklayer https://hooklayer.dev/api/mcp in your terminal. Add --scope user to make it available in every project.
How do I add Hooklayer MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Hooklayer MCP provide?
It exposes 12 tools, including analyze_account, search_videos, score_hook, viral_remix, trend_pulse.
Does Hooklayer allow editing or deleting content on social media?
No, all tools are non-destructive and Hooklayer has no tools that edit or delete data on external social platforms.
Is there a free tier available?
Yes, you can get 100 lifetime credits for free upon signing up without requiring a credit card.
What authentication methods are supported?
Hooklayer supports both API keys (Bearer tokens) and OAuth 2.1 with PKCE.