Danceo Video MCP
by jasonliu119
README.md
# 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.
```json
{
"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
```sh
npm install
npm run build
```
## Skill
The companion skill is included at
[`skills/ai-dance-video/SKILL.md`](skills/ai-dance-video/SKILL.md) and can also
be read or downloaded from the [Danceo MCP guide](https://danceo.ai/mcp?ref=github).
Install it from the public repository with:
```sh
npx skills add jasonliu119/danceo-ai-dance-mcp-skills
```
## Links
- [MCP and Skill source on GitHub](https://github.com/jasonliu119/danceo-ai-dance-mcp-skills?ref=github)
- [Danceo homepage](https://danceo.ai/?ref=github)
- [Danceo MCP guide](https://danceo.ai/mcp?ref=github)
- [Create an API key](https://danceo.ai/settings/apikeys?ref=github)
- [Danceo pricing](https://danceo.ai/pricing?ref=github)
## License
MIT. See [LICENSE](LICENSE).