Hooked MCP Server

Model Context Protocol server for the Hooked Video API. Let AI agents (Claude, GPT, Cursor, etc.) create videos programmatically.

Quick Setup

1. Get your API key

Sign up at hooked.so and create an API key in Settings → API Keys.

2. Add to Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "hooked": {
      "command": "npx",
      "args": ["-y", "@hooked-so/mcp"],
      "env": {
        "HOOKED_API_KEY": "your_api_key_here"
      }
    }
  }
}

3. Add to Cursor

Add this to your .cursor/mcp.json:

{
  "mcpServers": {
    "hooked": {
      "command": "npx",
      "args": ["-y", "@hooked-so/mcp"],
      "env": {
        "HOOKED_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools

Tool	Description
list_avatars	List available AI avatars
list_voices	List available AI voices
list_music	List background music tracks
create_script_to_video	Create video from a script with AI avatar
create_prompt_to_video	Create video from a text prompt (AI generates everything)
create_tiktok_slideshow	Create TikTok-style slideshow
create_ugc_ad	Create UGC-style ad video
get_video	Check video status and get download URL
list_videos	List recent videos
get_trending_videos	Get trending videos for inspiration

Example Prompts

Once connected, you can ask your AI assistant:

• "Create a 30-second product video for my new app using avatar Sophia"
• "Make a TikTok slideshow about 5 productivity tips"
• "What avatars are available? Show me the female ones"
• "Check the status of my last video"
• "What's trending on TikTok in the fitness niche?"

Environment Variables

Variable	Required	Description
HOOKED_API_KEY	Yes	Your Hooked API key
HOOKED_API_URL	No	Custom API base URL (default: https://api.hooked.so)

Development

pnpm install
pnpm build

License

MIT