score_video_hook

Analyze the first ~6 seconds of a YouTube video for hook quality. Returns archetype classification, five dimension scores, and concrete suggestions.

MCP score_video_hook 10 credits REST equivalent: POST /v1/score/video-hook

REST vs MCP response shape

MCP tool responses include two extra fields that the REST endpoint does not return:

score_id — an immutable identifier for the call, useful for client-side correlation and replay.
credits_remaining — your balance after this call. REST clients fetch the balance via GET /v1/usage/.

benchmark_channel and benchmark_video additionally wrap the response body under a payload field, so the envelope is {score_id, credits_remaining, payload}. The other tools merge the fields at the top level.

This is intentional. Tool-using agents typically want both pieces of state inline; HTTP clients usually do not.

Parameters

Parameter	Type	Description
youtube_url required	url (≤1024 chars)	Public YouTube URL. Accepts watch URLs, youtu.be, /shorts/, and /embed/ forms.

Example call

Tool invocation via an MCP client (JSON arguments):

{
  "youtube_url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}

Example response

{
  "score_id": "01J7K5...",
  "primary_archetype": "curiosity_gap",
  "secondary_archetype": "promise",
  "scores": {
    "clarity": 7,
    "specificity": 6,
    "tension": 8,
    "visual_energy": 7,
    "pace": 6
  },
  "overall_score": 72,
  "transcript": "What if I told you the most-watched ad of 1999...",
  "visual_summary": "Wide shot of presenter, retro graphics insert at 2s",
  "strengths": [
    "Strong curiosity gap up front",
    "Visual hook lands in 2s"
  ],
  "weaknesses": [
    "Specificity dips after the gap",
    "No stakes statement"
  ],
  "suggestions": [
    "Name the dollar figure in second 1",
    "Cut the b-roll at 4s"
  ],
  "delta_vs_niche_top": -12,
  "key_differences_vs_top": [
    "Top hooks name a number sooner",
    "Top hooks intercut faster"
  ],
  "credits_remaining": 334
}

Client setup

See Client setup for Claude Desktop and Cursor configuration. Once configured, ask your client to call score_video_hook.