Repository avatar
AI Tools
v0.1.2
active

danceo-video-mcp

io.github.jasonliu119/danceo-video-mcp

Create dance videos from portraits and Danceo templates using purchased credits.

Documentation

Danceo Video MCP

An MCP stdio server for creating AI dance videos with Danceo. It wraps Danceo's API key endpoints and keeps video generation, credit accounting, and task status in Danceo.

Tools

  • list_dance_templates lists the Danceo reference videos supported by the API.
  • get_credits checks the key owner's current credit balance.
  • create_dance_video starts an asynchronous render from public portrait URLs and one listed template ID.
  • get_video_status checks a render and returns its video URL when complete.

The render endpoint charges the account's current Danceo credit quote. The MCP server does not accept arbitrary reference video URLs; use a template returned by list_dance_templates. The portrait URL must be publicly reachable over HTTPS. Use images and likenesses you own or have permission to transform.

Configuration

Create an API key in Danceo settings, then configure the server in an MCP client. The package is available from npm as danceo-video-mcp:

Danceo requires an account and purchased credits; there is currently no free credit allowance. Check the current price before creating a render.

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

DANCEO_API_URL is optional and defaults to https://danceo.ai. Use an HTTPS URL for alternate deployments. API keys are sent only in the Authorization header and are never written to logs.

Build from source

npm install
npm run build

Skill

The companion skill is included at skills/ai-dance-video/SKILL.md and can also be read or downloaded from the Danceo MCP guide. Install it from the public repository with:

npx skills add jasonliu119/danceo-ai-dance-mcp-skills

Links

License

MIT. See LICENSE.

NPM
danceo-video-mcp
Install Command
npm install danceo-video-mcp