Skip to main content

​
Overview

The Hooked MCP Server (@hooked/mcp) lets AI agents — Claude, Cursor, ChatGPT, and any MCP-compatible client — create videos, browse avatars, check status, and discover trends directly from a conversation.
What is MCP? The Model Context Protocol is an open standard that lets AI assistants interact with external tools and APIs natively.

​
Quick Setup

1

Get your API key

Go to app.tryhooked.ai → Settings → API Keys and generate a key.
2

Add the config

Paste the JSON config into your AI client (see below).
3

Start creating

Ask your AI to create a video. It handles everything.

​
Claude Desktop

Add this to your claude_desktop_config.json: 
{
  "mcpServers": {
    "hooked": {
      "command": "npx",
      "args": ["-y", "@hooked/mcp"],
      "env": {
        "HOOKED_API_KEY": "your_api_key_here"
      }
    }
  }
}
On macOS, the config file is at ~/Library/Application Support/Claude/claude_desktop_config.json

​
Cursor

Add this to .cursor/mcp.json in your project root: 
{
  "mcpServers": {
    "hooked": {
      "command": "npx",
      "args": ["-y", "@hooked/mcp"],
      "env": {
        "HOOKED_API_KEY": "your_api_key_here"
      }
    }
  }
}

​
Available Tools

The MCP server exposes 10 tools:

​
Video Creation

ToolDescription
create_script_to_videoCreate a video from a script with an AI avatar
create_prompt_to_videoAI generates script, visuals, and narration from a prompt
create_tiktok_slideshowCreate TikTok-style slideshow from images and text
create_ugc_adCreate UGC-style product ad with AI presenter

​
Resources

ToolDescription
list_avatarsBrowse 50+ realistic AI avatars
list_voicesBrowse AI voices in 30+ languages
list_musicBrowse background music tracks

​
Video Management

ToolDescription
get_videoCheck video status and get download URL
list_videosList all your generated videos
ToolDescription
get_trending_videosDiscover trending content for inspiration

​
Example Conversations

Once connected, you can interact naturally: Create a video:
“Create a 30-second product video for my fitness app. Use a young female avatar with an energetic tone.”
Browse resources:
“What AI avatars do you have? Show me the female ones.”
Check status:
“What’s the status of my latest video?”
Get inspiration:
“What’s trending on TikTok in the fitness niche? Create a video based on the top trend.”
Batch creation:
“Create 3 variations of a product ad with different hooks and avatars.”

​
Tool Details

​
create_script_to_video

{
  "script": "Your video script here...",
  "avatarId": "avatar_sophia_01",
  "voiceId": "voice_en_female_01",
  "musicId": "music_upbeat_01",
  "captionStyle": "karaoke",
  "webhook": "https://your-app.com/webhook"
}
ParameterTypeRequiredDescription
scriptstringYesThe script the avatar will speak
avatarIdstringYesAvatar ID from list_avatars
voiceIdstringNoVoice ID from list_voices
musicIdstringNoMusic ID from list_music
captionStylestringNoCaption style (e.g. karaoke, word-by-word)
webhookstringNoWebhook URL for completion notification

​
create_prompt_to_video

{
  "prompt": "A 30-second video about productivity tips for remote workers",
  "avatarId": "avatar_sophia_01",
  "webhook": "https://your-app.com/webhook"
}
ParameterTypeRequiredDescription
promptstringYesDescribe the video you want
avatarIdstringNoAvatar ID (AI picks one if omitted)
voiceIdstringNoVoice ID
webhookstringNoWebhook URL

​
Environment Variables

VariableRequiredDescription
HOOKED_API_KEYYesYour Hooked API key
HOOKED_API_URLNoCustom API base URL (default: https://api.tryhooked.ai/api)

​
Troubleshooting

Ensure npx is available in your PATH. Try running npx @hooked/mcp manually in a terminal to check for errors.
Verify your HOOKED_API_KEY is correct and active. Generate a new key at app.tryhooked.ai → Settings → API Keys.
Restart your AI client after adding the config. Some clients require a full restart to detect new MCP servers.

​
Next Steps

Skill File

Download the Hooked skill for Cursor and Claude

Webhooks

Receive notifications when videos are ready