Skip to main content
Glama
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).