Agents Index

Hook Detector

Online

Real TikTok and Instagram hooks that already work, in any language, with why each travelled.

Visit publisherConnectJSON

What it can do: 80 tools

  • create_accountCreate an account and get an API key with free credits. Needs a beta access code (access_code, HD-XXXX-XXXX; case and dashes do not matter): without one the error is 403 access_code_required, and a code that does
  • showcaseReal hooks this service has delivered, for a wait screen: talking heads only, each hook_id, still_url (a JPEG, no key needed), platform, creator, views and line (the banner on the video, else its opening line). T
  • find_hooksStart hook research on a topic across TikTok, Instagram and YouTube Shorts (Shorts only, never long-form YouTube; platform "youtube"). platforms (since 2026-10-10, any of "tiktok", "instagram", "youtube"; all thr
  • get_runA research run: its status, progress, charge and every hook it produced. wait_seconds 0 to 50: wait up to that long for the run to finish, returning the moment it is done or failed. Use wait_seconds=50 and call
  • list_runsYour research runs, newest first, without their results, limit 1 to 100 (default 20) per page. Each run says its kind: "short" (find_hooks), "long" (find_long_hooks) or "packaging" (find_packaging); pass kind to
  • find_long_hooksFind long-form hooks: how the YouTube videos that beat their own channel open, on a topic. Long-form YouTube only, never Shorts, TikTok or Instagram (for those: find_hooks). What it does: searches YouTube for lo
  • find_packagingFind packaging: the titles and thumbnails that earned the click on a topic, from long-form YouTube videos that beat their own channel. What it does: runs the same outlier search as find_long_hooks (long-form You
  • save_presetSave filters under a name for one tab: "long", "packaging" or "library" (the bounds are those of find_packaging's filters; a library preset may also hold min_comments, max_comments, posted_within_days and languag
  • list_presetsYour saved filter presets, the newest change first; tab ("long", "packaging", "library") narrows. Same as GET /v1/presets. Free.
  • delete_presetDelete one of your presets. Same as DELETE /v1/presets/{preset_id}. Free. Errors: 404 preset_not_found.
  • write_titlesWrite 20 to 40 titles for your video, each borrowing the device and structure of one real outlier (a video that beat its own channel): the finds of one of your runs, or the shared index's videos nearest your topi
  • write_ideasWrite ideas for new videos: each a title, a thumbnail concept (one visible action) and the words to print, built on one to three real outliers (based_on, each with its video_id, title, multiple, find_id and bend
  • get_callOne call of a priced tool (titles and the tools after it): tool, credits, charged, status (pending, done, failed), request and result. Same as GET /v1/calls/{call_id}. Free. Errors: 404 call_not_found.
  • list_callsYour calls of priced tools, newest first; tool ("titles", ...) narrows. Same as GET /v1/calls. Free.
  • find_similarThe videos in the shared index nearest one of your finds (find_id from a Packaging or Long form run), nearest first, never the find's own video. Each has distance (0 is the same; measures says how it is computed)
  • search_thumbnailsThumbnails in the shared index by what the picture shows (q), or like a picture (image_url: read once by the model as subject, action, words and setting, then searched). Each result has matched_by (text or meanin
  • score_packageScore a package against the real outliers on its subject, part by part (title device, length, words on the picture, faces, the words' role, contrast, brightness): each part says how many outliers it matches; patt
  • preview_packageYour package in a mock YouTube feed among a run's winners: view home, search, sidebar, phone (marks where a phone cuts the title) or tv; theme dark or light; look normal, grey or blur. Returns png_base64 and mine
  • make_thumbnailsMake 2 to 12 thumbnails (default 4): 3 different concepts first, then images (Nano Banana 2.1, 1K or 4K), every printed word read back and checked letter by letter, a face only from your photos or your channel's
  • get_thumbnailsA thumbnails call: status, concepts and every image so far (url signed for 7 days, width, height, words, words_checked, cost_usd). Same as GET /v1/thumbnails/{call_id}. Free.
  • edit_thumbnailEdit one thumbnail (an image of your thumbnails call, or a picture you send): op erase, edit, face_swap, text, text_variations, upscale, fix, crop or color. crop and color are free; upscale 12; the rest 4 (a vers
  • recreate_thumbnailNew thumbnails for your video with a YouTube video's own thumbnail as the layout reference (2 to 4 images, every printed word checked); priced as make_thumbnails. Same as POST /v1/thumbnails/recreate; read it wit
  • optimize_videoNew packages (4, 8 or 12) for your published video: the original scored first against the real outliers on its subject, then each new package (title, thumbnail with every word checked, what it tests) scored the s
  • get_optimizeAn Optimize call: the original's score and every new package so far. Same as GET /v1/optimize/{call_id}. Free.
  • ab_setPack 2 or 3 images of one of your thumbnails, edit or Optimize calls for YouTube Studio's Test and Compare: a zip of A, B, C (1280x720, under 2 MB) and a note of what each tests. Free. Same as POST /v1/ab.
  • get_findOne result of a long or packaging run with every field: the video, its numbers and the opening or the package analysis. find_id comes from a run's finds (get_run) or from list_kept_finds. Same shape as GET /v1/fi
  • keep_findKeep or reject a find (a long-form hook or a package): verdict is "keep" (default) or "reject", and the last verdict wins. The verdict is the video's on that tab: every find of the same video you have there carri
  • clear_find_decisionUndo keep_find: the video goes back to having no verdict, on every find of it, and leaves list_kept_finds. Returns {"find_id", "verdict": null}. Clearing a find with no decision is the same success, so a retr
  • list_findsThe index: every video your long and packaging runs found, across all runs, one entry a video on each tab (its newest read, with the keep or reject made on the video). Each is a full find object: the title and th
  • remix_findMake it mine, for a long-form opening or a package: write up to n (1 to 5, default 3) new ones for your niche that keep one real find's structure. From a long find, `written` holds openings: hook (what the creato
  • list_remixesThe remixes you paid for from one hook (hook_id) or one find (find_id), newest first, each as its answer held it, with remix_id and created_at. Returns {"remixes": [...]}. Free. 404 hook_not_found or find_not_fou
  • get_remixOne remix you paid for (from remix_hook, remix_find or a chat turn), as its answer held it. Free. 404 remix_not_found for one that is not yours. Same as GET /v1/remixes/{remix_id}.
  • list_kept_findsThe videos you kept with keep_find (long-form hooks and packages), newest decision first: one entry a video on each tab across all runs, or the kept finds of one run_id, limit 1 to 100 (default 100) per page.
  • export_runA finished run's hooks as a file a creator can open: format "csv" (default; one row per hook, opens in any spreadsheet, formula-like cells defused with a leading quote), "json" (the full hook objects) or "md" (Ma
  • get_hookOne hook with every field: its opening line, transcript, watch_url and the vertical player_url (null only for an unusable id or a photo post found before 2026-09-26; runs deliver single videos only). hook_id come
  • embed_hookOfficial TikTok or Instagram embed HTML for a hook, so the clip plays inside your own page. kind is "embed", or "fallback" when the creator disabled embedding or the clip is a photo post found before 2026-09-26 (
  • keep_hookKeep or reject a hook: verdict is "keep" (default) or "reject", and the last verdict wins. A reject may say why: reason is off_subject, weak_opening, wrong_language, low_quality, already_have or other, and note (
  • clear_decisionUndo keep_hook: the hook goes back to having no verdict, so it leaves list_keeps and its export row carries none. Returns {"hook_id", "verdict": null}. Clearing a hook with no decision is the same success, so a r
  • remix_hookMake it mine: write up to n new opening lines (1 to 5, default 3) for your niche that keep a real hook's structure, the device that made it travel, with the subject swapped for yours. hook_id is one of your hooks
  • list_keepsThe hooks you kept with keep_hook, newest decision first, across all runs or within one run_id, limit 1 to 100 (default 100) per page. Returns {"kept": [...], "count": n on this page, "next_cursor"} with full hoo

…and 40 more.

Connect it

Claude Code
claude mcp add --transport http hook-detector https://api.hookdetector.com/mcp
Claude.ai / ChatGPT
Settings → Connectors → Add custom connector
URL: https://api.hookdetector.com/mcp
Cursor (~/.cursor/mcp.json)
{
  "mcpServers": {
    "hook-detector": {
      "url": "https://api.hookdetector.com/mcp"
    }
  }
}
VS Code (.vscode/mcp.json)
{
  "servers": {
    "hook-detector": {
      "type": "http",
      "url": "https://api.hookdetector.com/mcp"
    }
  }
}

Questions

What does Hook Detector do?

Real TikTok and Instagram hooks that already work, in any language, with why each travelled. It exposes 80 tools to AI assistants.

What tools does Hook Detector provide?

80 tools, including create_account, showcase, find_hooks, get_run, list_runs, find_long_hooks, find_packaging, save_preset, list_presets, delete_preset, write_titles, write_ideas….

How do I connect Hook Detector to Claude, ChatGPT or Cursor?

Add the remote MCP endpoint https://api.hookdetector.com/mcp as a custom connector or MCP server. Copy-paste setup is on this page.

Does Hook Detector require an account or API key?

No sign-in was needed to list its tools. Individual tools may still need an account or API key.

Is Hook Detector online?

As of 2026-11-19 our probe found it online. It answered 100% of our last 3 checks.

Who publishes Hook Detector?

hookdetector.com. The official MCP Registry verified that the publisher controls this domain before accepting the listing.

Similar in Social Media