Compeller
Create and track AI music videos and audio-reactive visuals from songs.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http compeller 'https://compeller.ai/api/mcp' --header 'Authorization: <Bearer token from Compeller Account → API Access, POST /api/login, or POST /api/v1/auth/token. Discovery tools work without this header; generation/account tools require it.>' --header 'X-API-Token: <Alternative Compeller API token header. Use this instead of Authorization if your MCP client stores token values without the Bearer prefix.>'
{
"mcpServers": {
"compeller": {
"type": "http",
"url": "https://compeller.ai/api/mcp",
"headers": {
"Authorization": "<Bearer token from Compeller Account → API Access, POST /api/login, or POST /api/v1/auth/token. Discovery tools work without this header; generation/account tools require it.>",
"X-API-Token": "<Alternative Compeller API token header. Use this instead of Authorization if your MCP client stores token values without the Bearer prefix.>"
}
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
Compeller MCP
Public documentation and metadata for the hosted Compeller MCP server.
Compeller turns music into performance-ready visuals. Agents can discover styles and pricing, search for music, create and track Compels, start renders, retrieve finished videos, and register signed webhooks for completion events.
This repository contains public connector documentation and metadata only. The production Compeller application source code is not published here.
Remote MCP endpoint
https://compeller.ai/api/mcp
- Namespace:
ai.compeller/compel - Server:
compeller-mcp - Version:
0.5.0 - Transport: Streamable HTTP JSON-RPC over HTTPS
- Official MCP Registry: https://registry.modelcontextprotocol.io/v0.1/servers?search=ai.compeller%2Fcompel
- Smithery: https://smithery.ai/servers/info-nijd/compeller
Quick config
Most MCP clients that support remote Streamable HTTP servers can use:
{
"mcpServers": {
"compeller": {
"url": "https://compeller.ai/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_COMPELLER_API_TOKEN"
}
}
}
}
If your MCP client stores raw token values without the Bearer prefix, use the alternate header:
{
"mcpServers": {
"compeller": {
"url": "https://compeller.ai/api/mcp",
"headers": {
"X-API-Token": "YOUR_COMPELLER_API_TOKEN"
}
}
}
}
Discovery works without authentication. Generation, account, media, rendering, and webhook tools require a Compeller API token.
Public docs and discovery
- MCP docs: https://compeller.ai/api/mcp/docs.md
- Agent manifest: https://compeller.ai/agents.json
- LLM guide: https://compeller.ai/llms.txt
- OpenAPI: https://compeller.ai/api/v1/openapi.yaml
- Health: https://compeller.ai/api/v1/health
Tool surface
Compeller currently exposes 20 MCP tools:
Discovery
get_capabilitiesget_pricinglist_stylessearch_music
Media and generation
upload_mediasearch_mediacreate_compel_from_musiccreate_compelget_compelstart_renderlist_compelssearch_compelslist_renderingsget_rendering
Webhooks
register_webhooklist_webhooksupdate_webhookdelete_webhooktest_webhook_deliveryrotate_webhook_secret
Webhook deliveries are signed with X-Compeller-Signature: sha256=<hex> over the raw request body. Secrets are returned exactly once on registration or rotation.
Example prompts
- “Search for Midnight City by M83 and create a cinematic Compeller visual.”
- “Show me available Compeller visual styles.”
- “Check the status of Compel 12345.”
- “Start the render for this READY Compel.”
- “Register a webhook for completed/failed Compeller events.”
Directory listing copy
Short description:
Create AI music videos and audio-reactive visuals from songs through MCP.
Longer description:
Compeller is a creator media pipeline for music. The MCP server lets agents discover styles and pricing, search music, create and track Compels, upload media, start renders, retrieve renderings, and register signed webhooks for completion events. Completed renderings can also be loaded into REACT, Compeller's desktop app for live audio-reactive shows.
Suggested tags:
AI, Music, Video Generation, Audio Reactive, Creative Tools, MCP, Remote MCP, Generative Art, Creator Tools, Entertainment
License
The documentation and metadata in this repository are published under the MIT License.
Frequently asked questions
What is Compeller?
Create and track AI music videos and audio-reactive visuals from songs.
How do I install Compeller?
It runs as a remote server. In Claude Code: claude mcp add --transport http compeller 'https://compeller.ai/api/mcp' --header 'Authorization: <Bearer token from Compeller Account → API Access, POST /api/login, or POST /api/v1/auth/token. Discovery tools work without this header; generation/account tools require it.>' --header 'X-API-Token: <Alternative Compeller API token header. Use this instead of Authorization if your MCP client stores token values without the Bearer prefix.>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Compeller need an API key?
Yes. It expects Authorization, X-API-Token, which you set in its configuration.
Is Compeller open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Compeller?
It is published by Compellerai. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.