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:

## 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