
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_templateslists the Danceo reference videos supported by the API.get_creditschecks the key owner's current credit balance.create_dance_videostarts an asynchronous render from public portrait URLs and one listed template ID.get_video_statuschecks 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.
danceo-video-mcpnpm install danceo-video-mcp