# Danceo Video MCP

> Danceo Video MCP is a paid MCP server for design and media. Create AI dance videos from a portrait and a reference template using Danceo credits. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** CLI, Web
- **Website:** https://danceo.ai/mcp
- **Repository:** https://github.com/jasonliu119/danceo-ai-dance-mcp-skills
- **MCP Registry name:** io.github.jasonliu119/danceo-video-mcp
- **Categories:** design and media
- **Listing updated:** 2026-11-14

## About

Danceo's server lets an assistant run the whole render loop: list the reference dance clips, check the credit balance, start a job and poll until the video is ready. Video creation works only with Danceo's listed reference templates; the API does not accept an arbitrary reference video or file upload.

Four tools are exposed. A person or dog template uses one portrait, while cat templates state how many photos they need, and portraits must be publicly reachable image URLs. Danceo validates inputs, calculates the credit cost and reserves credits before processing. The create call returns a job ID right away, and the output duration can be no longer than the chosen reference.

The server needs an API key from your Danceo account settings. The page warns that the npm package was not yet published when it was written, so the configuration shown was a preview. Credit packs start at 2,000 credits, about five renders.

## Features

- **Template listing:** Returns reference clips with IDs, durations and photo counts.
- **Credit check:** Shows the balance attached to your API key.
- **Async rendering:** Starts a job and returns an ID immediately.
- **Status polling:** Returns the video URL or a failure message.
- **Cost shown first:** Danceo calculates and reserves credits before rendering.
- **Companion skill:** A repo skill guides template and duration choice.

## Good for

- Turn a portrait into a short dance clip from a chat
- Check credits before starting a render
- Let an assistant track a render until it finishes
- Pick a template matching a pet or person photo

## Install

### Claude Code (Terminal)

```sh
claude mcp add danceo-video-mcp --env DANCEO_API_KEY='<DANCEO_API_KEY>' -- npx -y danceo-video-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "danceo-video-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "danceo-video-mcp"
      ],
      "env": {
        "DANCEO_API_KEY": "<DANCEO_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "danceo-video-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "danceo-video-mcp"
      ],
      "env": {
        "DANCEO_API_KEY": "<DANCEO_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "danceo-video-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "danceo-video-mcp"
      ],
      "env": {
        "DANCEO_API_KEY": "<DANCEO_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "danceo-video-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "danceo-video-mcp"
      ],
      "env": {
        "DANCEO_API_KEY": "<DANCEO_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "danceo-video-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "danceo-video-mcp"
      ],
      "env": {
        "DANCEO_API_KEY": "<DANCEO_API_KEY>"
      }
    }
  }
}
```

## Tools

- `list_dance_templates`: Returns reference clips with IDs, durations and photo counts.
- `get_credits`: Checks the credit balance for the API key.
- `create_dance_video`: Starts an asynchronous render from portrait URLs and a template ID.
- `get_video_status`: Checks a job and returns the video URL or a failure.

## FAQ

### What do I need to start?

A Danceo account and an API key created in API key settings.

### Can I use my own dance video?

No, only Danceo's listed reference templates are accepted.

### How are renders paid for?

With credits; packs and subscription plans are on the pricing page, with about five renders in the smallest pack.

### Do portraits need to be uploaded?

No upload; they must be publicly reachable image URLs.

### Is Danceo Video MCP free?

No. Danceo Video MCP is a paid product.

### How do I add Danceo Video MCP to Claude Code?

Run this command in your terminal: claude mcp add danceo-video-mcp --env DANCEO_API_KEY='<DANCEO_API_KEY>' -- npx -y danceo-video-mcp

### What are the best alternatives to Danceo Video MCP?

The closest alternatives to Danceo Video MCP are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [Eikino](https://ai-powered.com/mcp/eikino): Eikino is a freemium MCP server for security.
- [Hourlore](https://ai-powered.com/mcp/hourlore): Hourlore is a freemium MCP server for design and media.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/danceo-video-mcp
