ai.compeller/compel — MCP Server (Compeller)

The ai.compeller/compel MCP server creates and tracks AI music videos and audio-reactive visuals from songs. It exposes hosted capabilities for agents to discover styles and pricing, search for music, create and track Compels, start renders, retrieve finished videos, and register signed webhooks for completion events.

🛠️ Key Features

Create AI music videos and audio-reactive visuals from songs
Discover styles and pricing
Search for music
Create and track Compels
Start renders and retrieve finished videos
Register signed webhooks for completion events

🚀 Use Cases

Agent workflows that convert songs into performance-ready visuals
End-to-end render pipelines: create → render → fetch finished videos
Completion notifications via signed webhook events

⚡ Developer Benefits

Hosted remote MCP endpoint: https://compeller.ai/api/mcp
Tool coverage count: 30 tools

⚠️ Limitations

Public repository provides documentation and metadata only; production application source code is not published here.

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

text

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:

json

{
  "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:

json

{
  "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_capabilities
get_pricing
list_styles
search_music

Media and generation

upload_media
search_media
create_compel_from_music
create_compel
get_compel
start_render
list_compels
search_compels
list_renderings
get_rendering

Webhooks

register_webhook
list_webhooks
update_webhook
delete_webhook
test_webhook_delivery
rotate_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:

text

Create AI music videos and audio-reactive visuals from songs through MCP.

Longer description:

text

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:

text

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.

name	string	optional	Filename for the upload
mime_type	string	optional	MIME type of the file
type	string	optional	Media type: audio, image, video, or text

query	string	required	Song, artist, or album search query
limit	integer	optional	Max results to return (default 10, max 20)

track_id	integer	required	Deezer track id returned by search_music
title	string	optional	Optional compel title override
style	string	optional	Visual style. Use one of the exact ids returned by list_styles (e.g. "Cinematic Realistic", "Anime / Manga"). Omit to use the account default.
target_platform	string	optional	Target platform; sets the aspect ratio when aspect_ratio is omitted.
aspect_ratio	string	optional	Explicit aspect ratio override (takes precedence over target_platform).
artist_context	string	optional	Additional creative context

title	string	required	Title for the compel
primary_media_id	integer	required	ID of the uploaded audio media to use as the primary track
style	string	optional	Visual style. Use one of the exact ids returned by list_styles (e.g. "Cinematic Realistic", "Anime / Manga"). Omit to use the account default.
target_platform	string	optional	Target platform; sets the aspect ratio when aspect_ratio is omitted.
aspect_ratio	string	optional	Explicit aspect ratio override (takes precedence over target_platform).
artist_context	string	optional	Additional creative context about the artist or song

limit	integer	optional	Max results to return (default 20, max 100)
offset	integer	optional	Pagination offset

url	string	required	HTTPS URL to deliver events to (max 2048 chars)
events	array	optional	Event types to subscribe to. Omit or pass ["*"] for all. Known types: compel.ready (renderable - call start_render), compel.completed, compel.failed.

webhook_id	integer	required	The webhook id to update
url	string	optional	New HTTPS URL (max 2048 chars)
events	array	optional	Replacement event types. Omit to leave unchanged. ["*"] or an empty filtered list resets to wildcard.
active	boolean	optional	Toggle delivery on/off without losing the registration

stage_id	integer	optional	The stage to launch onto (must belong to the authenticated account)
effect_id	string	optional	COM-497 starter effect id from list_lighting_effects, e.g. "gobo-cycle"
variables	object	optional	Optional variable overrides (name -> value), e.g. {"speed": 0.5}. Defaults come from the effect.
launch_contract	object	optional	Advanced: an explicit launch_contract to launch instead of resolving one from effect_id.

launch_id	string	required	The launch_id of the cue to update
variables	object	required	Variables to set (name -> value), e.g. {"speed": 0.75}

launch_id	string	required	The launch_id to acknowledge
accepted	boolean	required	true when REACT/BAE accepted the cue for execution
rejected_reason	string	optional	Required by convention when accepted=false
executor_id	string	optional	Stable REACT/BAE executor instance id
observed_at	string	optional	Executor observation timestamp

ai.compeller/compel — MCP Server (Compeller)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

get_capabilities

get_pricing

list_styles

upload_media

search_music

create_compel_from_music

create_compel

get_compel

start_render

list_compels

search_compels

list_renderings

get_rendering

search_media

register_webhook

list_webhooks

delete_webhook

test_webhook_delivery

update_webhook

rotate_webhook_secret

cancel_compel

get_account_credits

list_lighting_effects

launch_lighting_cue

list_lighting_cues

get_lighting_cue

stop_lighting_cue

set_lighting_cue_variables

ack_lighting_cue

report_lighting_cue

Compeller MCP

Remote MCP endpoint

Quick config

Public docs and discovery

Tool surface

Discovery

Media and generation

Webhooks

Example prompts

Directory listing copy

License

Install

Remote endpoint

Related servers