Hooked Video Api Mcp

Name: Hooked Video Api Mcp
Author: hooked-so

Local

github.com/hooked-soDeveloper Tools0Updated 32w ago

Repository

About Hooked Video Api Mcp

An MCP server for the Hooked Video API, intended for users who want AI agents to create videos programmatically. Its tools cover script- or prompt-based generation, slideshows, and UGC-style ads.

Key features

01Browse available avatars, voices, and music
02Create avatar videos from scripts
03Generate videos from prompts
04Create TikTok-style slideshows
05Create UGC-style ad videos
06Check video status and recent videos

Use cases

01Make an avatar video from a product script
02Generate a TikTok-style slideshow on a topic
03Create a UGC-style ad and check its status

MCP support

The MCP server exposes Hooked Video API tools to AI clients, including video generation, asset listings, video status checks, recent video listings, and trending-video lookup.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

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

Run commandnpx -y @hooked-so/mcp

Environment variables to set

HOOKED_API_KEYSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npm@hooked-so/mcpstdio

Tools

Saved tool list · updated 3w ago

This tool takes no parameters.

Details

From the project README

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

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.