# io.github.khan-ashifur/hooklayer (remote · hooklayer.dev)

Viral-content intelligence for AI agents — 7 read-only MCP tools, evidence-layer scoring.

- Trust score: 75/100 (medium)
- Change this week: +9
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `hooklayer.dev`: 75/100 (this document), [markdown](https://verifymcp.io/servers/khan-ashifur-hooklayer/api-mcp.md), [page](https://verifymcp.io/servers/khan-ashifur-hooklayer/api-mcp)

## Channel facts

- Endpoint: `https://hooklayer.dev/api/mcp`
- Transports: `streamable-http`
- Auth: `required`
- Version: `1.1.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 94/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation is enforced on tool calls, advertised via RFC 9728 protected-resource metadata. Discovery is public, which costs nothing: no tool can be invoked without a token.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
  - The authorisation server offers only Dynamic Client Registration (RFC 7591), which MCP 2026-07-28 deprecated in favour of Client ID Metadata Documents.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 60/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 2581 tokens (~286/item across 9 items; 9 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 27/100
  - Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 20/100
  - Spec-recency check failed: implements MCP spec 2024-11-05; the latest is 2026-07-28.

## Install

### Claude

```bash
claude mcp add --transport http khan-ashifur-hooklayer https://hooklayer.dev/api/mcp
```

### Codex

```toml
[mcp_servers.khan-ashifur-hooklayer]
url = "https://hooklayer.dev/api/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "khan-ashifur-hooklayer": {
      "type": "remote",
      "url": "https://hooklayer.dev/api/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add khan-ashifur-hooklayer --url https://hooklayer.dev/api/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  khan-ashifur-hooklayer:
    url: "https://hooklayer.dev/api/mcp"
```

### Other

```json
{
  "mcpServers": {
    "khan-ashifur-hooklayer": {
      "type": "http",
      "url": "https://hooklayer.dev/api/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 75, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-01 (score 74, +1)

- [security] Tool “analyze_account” rewrote its description, which is the text the model reads
- [security] Tool “brief_to_blueprint” rewrote its description, which is the text the model reads

### 2026-07-31 (score 73, +5)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 68, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-28 (score 67, +1)

No change was recorded against any check on this day. Stability & Change Management went from 3 to 7. That category is still filling its 30-day observation window: 1 days of observed history at the previous scan, 2 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-27 (score 66, +1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 65)

First indexed and scored.

## MCP tools (9)

### `analyze_account` (~484 tokens)

Analyze a TikTok, YouTube, or Instagram creator by handle or channel ID. Returns viral DNA scores (viral_dna_score, replicability_score, originality_score, consistency_score, audience_fatigue), content patterns, format fingerprint, top recent videos with transcripts, content gaps, a headline_insight object (the single largest quantified performance gap across length, hook, format, and cadence, plus its so_what), and suggested next research steps. Use when the user asks to analyze a creator, account, channel, or competitor. Supports TikTok (full transcript extraction), YouTube (Shorts and longform analysis with captions when available), and Instagram (Reels with best-effort transcripts).

Input parameters:

- `handle` (string, required): Creator handle (with or without @ prefix) or YouTube channel ID. Examples: "@mrbeast", "mrbeast", "UCX6OQ3DkcsbYNE6H8uQQuVA".
- `platform` (string): Platform to analyze. "tiktok" (default) returns full pipeline with transcripts. "youtube" analyzes recent Shorts via YouTube Data API + Innertube caption extraction — videos with captions disabled or…
- `recent_only` (boolean): When true, hard-cap the candidate pool to videos posted in the last 90 days. Stricter than `window=90d` because it never falls through to archival data on a thin recent corpus.
- `since` (string): Optional ISO date (e.g. "2026-04-01"). Filter the candidate video pool to those posted on/after this date. Useful when the user asks "show me what they've done THIS month" — the route returns honest…
- `window` (string): Recency sugar — same effect as `since` but takes a friendlier bucket. Maps to a since-cutoff at request time. Use either `since` or `window`, not both.

Output parameters:

- `content_gaps` (array): Untapped content opportunities the creator is missing
- `credits_remaining` (number): Credits remaining after this call
- `format_fingerprint` (object): Dominant content format patterns (durations, styles, edit types)
- `from_payg` (boolean): Whether credits came from pay-as-you-go balance
- `from_subscription` (boolean): Whether credits came from subscription
- `headline_insight` (object): The largest quantified performance gap for this creator, plus its implication. Presentation-neutral data — the caller decides whether and how to surface it.
- `pattern_analysis` (object): Content pattern breakdown (posting cadence, topic clusters)
- `profile` (object): Creator profile (handle, bio, followers, following, total_likes, total_videos)
- `recent_videos` (array): Top recent videos with view counts, transcripts, and engagement
- `recommended_chain` (array): Suggested next tool calls with pre-filled parameters — advisory only, agent decides whether to execute
- `steal_map` (array): Actionable elements to replicate from this creator
- `viral_dna` (object): Five viral DNA scores (0-100 each)

### `score_hook` (~124 tokens)

Score a TikTok, Reels, or Shorts hook against proven viral patterns. Returns a 0-100 score, percentile rank, matched pattern, strengths, weaknesses, and three improved hook variations. Use when the user has a draft hook to validate, wants to compare alternatives, or needs feedback before publishing.

Input parameters:

- `niche` (string): Optional niche context (e.g. "Beauty & Skincare", "Finance & Business")
- `platform` (string, required): Target platform — affects pattern matching
- `text` (string, required): The hook to score (3-200 chars typical)

Output parameters:

- `breakdown` (object): Sub-scores (0-100) for five quality dimensions
- `credits_remaining` (number): Credits remaining after this call
- `from_payg` (boolean): Whether credits came from pay-as-you-go balance
- `from_subscription` (boolean): Whether credits came from subscription
- `pattern_match` (string): Matched viral pattern name
- `percentile` (number): Percentile rank vs all scored hooks
- `rewrites` (array): Three rewritten versions at higher quality
- `score` (number): Hook quality score (0-100)
- `strengths` (array): What the hook does well
- `weaknesses` (array): What could be improved
- `why` (string): One-sentence verdict explaining the score

### `viral_remix` (~160 tokens)

Take a viral video and produce a fresh script that mirrors its structure and energy pattern for a new topic. Returns the extracted formula, scene-by-scene script with voiceover and visuals, camera directions, and text overlays. Use when the user finds a video they want to replicate the structure of. Pass either a video URL (TikTok, YouTube, or Instagram) or a transcript directly.

Input parameters:

- `my_topic` (string): What the remix should be about. Default: same niche as original.
- `niche` (string): Optional niche hint
- `source_url` (string): TikTok/YouTube/Instagram URL — transcript will be auto-extracted
- `transcript` (string): Pre-extracted transcript (alternative to source_url, faster)

Output parameters:

- `camera_shots` (array): Phone-native camera direction per scene
- `credits_remaining` (number): Credits remaining after this call
- `cta_archetype` (string): Which CTA archetype the generator picked. Comment_gate is the failure-mode default for AI script generators; rotation tells you whether the prompt is working.
- `extracted_formula` (string): The viral DNA formula extracted from the source
- `fresh_script` (object): Complete scene-by-scene script mirroring the source structure
- `from_payg` (boolean): Whether credits came from pay-as-you-go balance
- `from_subscription` (boolean): Whether credits came from subscription
- `overlays` (array): Text overlay suggestions per scene
- `structural_skeleton` (string): Which structural skeleton the generator used (confession_to_result, mistake_to_correction, etc). Surfaces rotation across the fleet.
- `ugc_authenticity` (object): Tripwire for ad-shaped drift. Detected via regex on the produced script, not the model self-grade. If level=ad_leaning, surface to the user before shipping.
- `verify_hook` (object): The hook plus a suggested follow-up: the caller may pass it to score_hook for a structurally-independent score (the script generator deliberately does NOT self-rate). Informational only, not an instr…

### `trend_pulse` (~300 tokens)

Research what is currently gaining traction in short-form content for a specific niche. Returns rising opportunities (formats, hooks, styles, topics) with growth signals, data sources, and saturated patterns to avoid. Use when the user asks what to post about, what's trending in a niche, or needs to validate a content idea against current trends. Supports 17 niches and optional region filtering.

Input parameters:

- `deadline_hours` (integer): Optional (2026-07-06 magic-genie ritual): how many hours until the video posts. When set, each rising trend gets a trend_status (up-slope | plateau | fading | unknown) AND a deadline_verdict (safe |…
- `niche` (string): One of the 17 supported niches. Loose names like "travel" or "fitness" are accepted but pass the canonical form when possible. Omit for broadly applicable trends.
- `region` (string): Optional 2-letter ISO country code (US, GB, BR, JP, IN, PH, etc.). Threads to Google Trends geo + YouTube regionCode. Defaults to US when omitted. Reddit signals are global and ignore this param.

Output parameters:

- `credits_remaining` (number): Credits remaining after this call
- `from_payg` (boolean): Whether credits came from pay-as-you-go balance
- `from_subscription` (boolean): Whether credits came from subscription
- `niche` (string): The niche these trends apply to
- `rising` (array): Rising opportunities (format/hook/style) with qualitative growth labels + signal_strength numeric anchor (0-1) + suggestions
- `saturated` (array): Saturated patterns to avoid

### `find_viral_template` (~434 tokens)

Find proven viral templates in a niche with example videos. Returns templates ranked by performance, including hook patterns, format structures, average views, and example URLs. Use when the user asks what's working in a niche or wants concrete copyable structures. Supports 17 niches with optional angle narrowing via query parameter for more specific results (e.g., "postpartum strength" within Fitness).

Input parameters:

- `min_views` (integer): Optional filter — only return examples above this view count
- `niche` (string, required): One of the 17 supported niches. Loose names like "travel" or "fitness" are accepted but pass the canonical form when possible.
- `platform` (string): Platform to source templates from. "tiktok" (default) uses the full niche-aggregator (YouTube + Reddit + TikTok hashtags). "instagram" (2026-07-06) is keyword-search-only — the Instagram niche-aggreg…
- `query` (string): Optional angle narrowing within the niche. E.g. niche="Fitness & Health" + query="postpartum strength" returns only postpartum-strength templates, not generic gym. Templates are scored by query-token…
- `region` (string): Optional 2-letter ISO country code (US, GB, BR, JP, IN, PH, etc.). Threads to YouTube Search regionCode + TikTok niche query. Reddit niche signals are global and ignore this param. Pass when the user…
- `window` (string): Recency filter. Drops example videos older than the window. Note: TikTok hashtag-corpus rows often lack timestamps and are excluded when window is set — surfaces as a quality warning so callers can d…

Output parameters:

- `credits_remaining` (number): Credits remaining after this call
- `from_payg` (boolean): Whether credits came from pay-as-you-go balance
- `from_subscription` (boolean): Whether credits came from subscription
- `niche` (string): The niche searched
- `templates` (array): Ranked viral templates with hook patterns and example URLs

### `search_videos` (~325 tokens)

Search for short-form videos by keyword across TikTok or Instagram. Returns up to 20 videos ranked by engagement, with view counts, likes, shares, comments, hashtags, author info, and URLs. Use when the user asks to find videos about a topic or keyword. Supports optional filters for niche, minimum views, recency window, and region.

Input parameters:

- `limit` (integer): Max videos to return after filtering. Default 12, max 20.
- `min_views` (integer): Optional view-count floor. Default 0.
- `niche` (string): Optional — only return videos whose description contains niche-related tokens. Loose niche strings work ("fitness", "Beauty & Skincare").
- `platform` (string): Which platform to search. "tiktok" (default) hits ScrapeCreators TikTok keyword search. "instagram" (2026-07-06) hits Instagram Reels search — note IG upstream ignores region/date_posted params, so r…
- `query` (string, required): Free-text search term. Examples: "morning routine", "iphone case", "passive income".
- `region` (string): ISO country code (US, GB, BR, PH, JP, etc.). Note: corpus coverage varies by region — small regions may return zero results and a degraded quality flag.
- `window` (string): Recency filter. Maps to the closest ScrapeCreators date bucket AND applies a client-side cutoff for defense-in-depth.

Output parameters:

- `applied` (object): Echo of the filters actually applied — useful for debugging when results look surprising
- `credits_remaining` (number): Credits remaining after this call
- `filtered_count` (number): Videos returned after filtering + cap
- `from_payg` (boolean)
- `from_subscription` (boolean)
- `quality` (object)
- `upstream_count` (number): Videos returned by upstream before any filtering
- `videos` (array)

### `match_voice` (~115 tokens)

Extract a creator's voice DNA from reference samples and rewrite a draft in their style. Requires at least 3 reference samples (video URLs or text). Returns voice profile (energy, humor, vocabulary, signature phrases), reusable prompt instructions, and the rewritten draft. Use when the user wants to write in another creator's style or match a specific voice.

Input parameters:

- `draft` (string, required): The text to rewrite
- `reference_samples` (array, required): At least 3 reference samples — TikTok/YouTube/Instagram URLs or raw text

Output parameters:

- `credits_remaining` (number): Credits remaining after this call
- `from_payg` (boolean): Whether credits came from pay-as-you-go balance
- `from_subscription` (boolean): Whether credits came from subscription
- `prompt_instructions` (string): Reusable prompt to replicate this voice
- `rewritten_draft` (string): The input draft rewritten in the matched voice
- `voice_profile` (object): Extracted voice DNA profile

### `predict_virality` (~109 tokens)

Score a draft script for viral potential with adversarial verification. Returns a virality score, recommendation (ship/rework/no-go), viral DNA breakdown with evidence, attack vectors analysis, and calibration metrics. Use when the user has a finished draft and wants pre-publish verification. Pass either a script string or a video URL.

Input parameters:

- `niche` (string): Niche context
- `script` (string, required): The draft script to predict on (or a video URL — auto-extracts transcript)

Output parameters:

- `blueprint` (object): Retention diagnosis with weak seconds identified
- `credits_remaining` (number): Credits remaining after this call
- `from_payg` (boolean): Whether credits came from pay-as-you-go balance
- `from_subscription` (boolean): Whether credits came from subscription
- `share_reason` (string): Why viewers would share this content
- `target_emotion` (string): Primary emotion the content targets
- `viral_dna` (object): Hook type, structure, emotional triggers breakdown
- `virality_score` (number): Overall virality prediction (0-100)

### `brief_to_blueprint` (~530 tokens)

Turn a brand brief that just landed into a one-page creative blueprint the manager can forward to the creator and to the brand contact — hook + template + hashtag combo + trend-velocity check + shoot instructions, in one call. Use when a brand sends a product and needs content on a tight turnaround (e.g. "product arrived, need content in 48 hours") and the manager needs a defensible direction with no research time. Chains find_viral_template + trend_pulse + score_hook + predict_virality upstream but exposes them as one MCP tool so agents don't stitch them manually. Cost 7 credits (bundle discount vs firing the chain manually). Returns a blueprint object with verdict (GO | NEEDS_MORE_DATA | NO_GO) and verdict_reason, a hook (text + trend_still_alive: up-slope | plateau | fading | unknown), script, hashtags, shoot notes, risk flags, and manager talking points, plus a quality object (level + reason) describing completeness; when quality.level is not "full", or verdict is NEEDS_MORE_DATA or NO_GO, the blueprint is a starting point rather than a shippable direction.

Input parameters:

- `creator_handle` (string): Optional creator handle (with or without @). If provided, the blueprint hook and script match THEIR voice patterns from recent videos. Highly recommended — a blueprint without creator context is gene…
- `deadline_hours` (integer): How many hours until the video must be posted. Default 48. Affects trend-still-alive scoring — a 24-hour deadline needs a trend on the up-slope, not one that just plateaued.
- `niche` (string, required): One of the 17 supported niches. Loose names like "beauty" or "fitness" are auto-mapped.
- `platform` (string): Target platform. Both TikTok and Instagram Reels supported (shipped 2026-07-06). When set to "instagram", the product-corpus lookup runs against Instagram Reels via ScrapeCreators, and the creator co…
- `product` (string, required): What the brand sent (name + one line, e.g. "Athletic Greens AG1 travel packs — 30-count individual sachets for travel")
- `product_category` (string, required): Umbrella category (e.g. "greens powder", "sunscreen", "protein bar")
- `region` (string): Optional 2-letter ISO country code (US, GB, CA, etc.). Threads to niche + trend upstreams.

Output parameters:

- `applied` (object): Echo of parameters resolved after canonicalization
- `as_of` (string)
- `blueprint` (object)
- `credits_remaining` (object)
- `provenance` (object)
- `quality` (object)
- `stats` (object)
- `success` (boolean)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/khan-ashifur-hooklayer/api-mcp#diagnostics

## Score history

- 2026-08-03: 75
- 2026-08-02: 74
- 2026-08-01: 74
- 2026-07-31: 73
- 2026-07-30: 68
- 2026-07-29: 67
- 2026-07-28: 67
- 2026-07-27: 66
- 2026-07-26: 65

## Links

- Remote endpoint: https://hooklayer.dev/api/mcp
- Authorisation metadata: https://hooklayer.dev/.well-known/oauth-protected-resource/api/mcp
- Repository: https://github.com/khan-ashifur/hooklayer
- Website: https://hooklayer.dev/
- Changelog RSS feed: https://verifymcp.io/servers/khan-ashifur-hooklayer/api-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/khan-ashifur-hooklayer/api-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/khan-ashifur-hooklayer/api-mcp