Generate Video MCP

Let AI generate videos directly in Claude Desktop, OpenCode, Cursor, and other MCP-compatible clients.

Setup

1. Get an API key

Register at agnes-ai.com to get your API key (free quota available).

2. Add to Claude Desktop

Open (or create) the config file at:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Paste this, replacing your-api-key-here with your actual key:

{
  "mcpServers": {
    "generate-video": {
      "command": "npx",
      "args": ["-y", "generate-video-mcp"],
      "env": {
        "AGNES_API_KEY": "your-api-key-here"
      }
    }
  }
}

3. Restart Claude Desktop

Done. Ask your AI: "Generate a 5-second video of waves crashing on a beach".

Other clients

Same JSON block, just put it in the config file for your client:

| Client | Config file | |--------|-------------| | Claude Desktop | %APPDATA%\Claude\claude_desktop_config.json | | OpenCode | ~/.config/opencode/opencode.json (wraps in "mcp": { ... }) | | Cursor | ~/.cursor/mcp.json | | Windsurf | ~/.windsurf/mcp.json | | Cline (VS Code) | Cline MCP settings UI |

Configuration

| Variable | Required | Default | Description | |----------|----------|---------|-------------| | AGNES_API_KEY | Yes | — | Your Agnes AI API key | | AGNES_API_URL | No | https://apihub.agnes-ai.com | API base URL |

Tools

Once installed, your AI gains two tools:

generate_video

Generate a video from a text description.

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | prompt | string | Yes | — | Video description | | duration | number | No | 5 | Duration in seconds (1–20) | | size | string | No | 1152x768 | Resolution (WxH) |

check_video_status

Check progress of a video generation task.

| Parameter | Type | Required | Default | |-----------|------|----------|---------| | task_id | string | Yes | — |

From source (for developers)

git clone https://github.com/m1908293028-boop/generate-video-mcp.git
cd generate-video-mcp
npm install
npm run build

Then configure with the local path:

{
  "mcpServers": {
    "generate-video": {
      "command": "node",
      "args": ["path/to/generate-video-mcp/dist/server.js"],
      "env": {
        "AGNES_API_KEY": "your-api-key-here"
      }
    }
  }
}

## License

MIT