Create and track AI music videos and audio-reactive visuals from songs.
Generate and track AI-created music videos with audio-reactive visual effects.
Captured live from the server via tools/list.
get_capabilities
Get Compeller platform capabilities, supported features, and API version.
No parameters.
get_pricing
Get current Compeller subscription plans and pricing.
No parameters.
list_styles
List available visual styles for Compeller video generation.
No parameters.
upload_media
Get upload instructions for media files (audio, images, video). Returns the upload URL and required headers. Requires API token authentication.
Parameters (3)
namestring
Filename for the upload
mime_typestring
MIME type of the file
typestring
Media type: audio, image, video, or text
search_music
Search Deezer preview tracks by song, artist, or album. Use this when the user provides a song string but no MP3/WAV/FLAC file.
Parameters (2)
querystringrequired
Song, artist, or album search query
limitinteger
Max results to return (default 10, max 20)
create_compel_from_music
Create a compel from a selected Deezer preview track. If the user provides an audio file instead, upload that file and use create_compel.
Parameters (6)
track_idintegerrequired
Deezer track id returned by search_music
titlestring
Optional compel title override
stylestring
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_platformstring
Target platform; sets the aspect ratio when aspect_ratio is omitted.
aspect_ratiostring
Explicit aspect ratio override (takes precedence over target_platform).
artist_contextstring
Additional creative context
create_compel
Create a Compeller generation job from primary audio media and optional reference media. Returns compel id, status, and links to track progress and retrieve renderings.
Parameters (6)
titlestringrequired
Title for the compel
primary_media_idintegerrequired
ID of the uploaded audio media to use as the primary track
stylestring
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_platformstring
Target platform; sets the aspect ratio when aspect_ratio is omitted.
aspect_ratiostring
Explicit aspect ratio override (takes precedence over target_platform).
artist_contextstring
Additional creative context about the artist or song
get_compel
Get the current status, progress, and details of a Compeller generation job.
Parameters (1)
compel_idintegerrequired
The compel ID to check
start_render
Start rendering a READY compel with default configuration so an agent can continue to final MP4 without opening the browser UI.
Parameters (1)
compel_idintegerrequired
The READY compel ID to render
list_compels
List all Compeller generation jobs for the authenticated account, newest first.
Parameters (2)
limitinteger
Max results to return (default 20, max 100)
offsetinteger
Pagination offset
search_compels
Search Compeller generation jobs by title for the authenticated account.
Parameters (2)
querystringrequired
Search query to match against compel titles
limitinteger
Max results to return (default 20)
list_renderings
List all video renderings for a specific compel.
Parameters (1)
compel_idintegerrequired
The compel ID to list renderings for
get_rendering
Get details of a specific video rendering.
Parameters (1)
rendering_idintegerrequired
The rendering ID to retrieve
search_media
Search and list uploaded media files for the authenticated account.
Parameters (3)
typestring
Filter by media type: audio, image, video, or text
limitinteger
Max results to return (default 20, max 100)
offsetinteger
Pagination offset
register_webhook
Register an HTTPS endpoint to receive signed push notifications for compel lifecycle events (compel.ready when renderable, compel.completed, compel.failed). Returns webhook_id and the HMAC-SHA256 signing secret exactly once - store the secret immediately, it is never returned again. Deliveries are signed via X-Compeller-Signature: sha256=<hex> over the raw body. Delivery is at-least-once: a failed delivery is retried with backoff (up to 6 attempts) and every retry carries the same X-Compeller-Event-Id, so dedupe on it.
Parameters (2)
urlstringrequired
HTTPS URL to deliver events to (max 2048 chars)
eventsarray
Event types to subscribe to. Omit or pass ["*"] for all. Known types: compel.ready (renderable - call start_render), compel.completed, compel.failed.
list_webhooks
List all webhook endpoints registered for the authenticated account. Secrets are never returned by this tool.
No parameters.
delete_webhook
Delete a webhook endpoint by id. Removes the registration and stops future deliveries.
Parameters (1)
webhook_idintegerrequired
The webhook id returned by register_webhook or list_webhooks
test_webhook_delivery
Synchronously POST a synthetic webhook.test event to a registered endpoint. Uses the same HMAC-SHA256 signature as real deliveries, runs the standard URL safety check at delivery time, and returns {webhook_id, event_id, event_type, delivered, response_status, response_body_preview, latency_ms, error?}. Ignores the endpoint's events subscription - test delivery is always on-demand. Use this to verify your integration before relying on compel.completed / compel.failed events.
Parameters (1)
webhook_idintegerrequired
The webhook id to test. Must belong to the authenticated account.
update_webhook
Update one or more mutable fields on a registered webhook endpoint: url, events, active. At least one of these must be provided. Validation mirrors register_webhook (https-only, <= 2048 chars, URL safety blocklist). Returns the updated endpoint (secret is never returned by this tool - use rotate_webhook_secret for that).
Parameters (4)
webhook_idintegerrequired
The webhook id to update
urlstring
New HTTPS URL (max 2048 chars)
eventsarray
Replacement event types. Omit to leave unchanged. ["*"] or an empty filtered list resets to wildcard.
activeboolean
Toggle delivery on/off without losing the registration
rotate_webhook_secret
Mint a new HMAC-SHA256 signing secret for a registered webhook endpoint. The previous secret is invalidated immediately - integrators must update their receiver before the next compel terminal event fires. Returns the new secret exactly once; store it on receipt.
Parameters (1)
webhook_idintegerrequired
The webhook id to rotate the secret on
cancel_compel
Cancel an in-progress compel. Dequeues it if still queued, otherwise cancels any active external (AI provider) tasks and transitions it to CANCELLED. Idempotent - cancelling an already-CANCELLED compel succeeds. Use to stop a mis-prompted or runaway job before it consumes more render minutes.
Parameters (1)
compel_idintegerrequired
The compel ID to cancel
get_account_credits
Get the authenticated account's render-minute balance and plan: minutes remaining (free + paid), monthly allowance, plan code, and whether the quota is exceeded. Call before starting an expensive render so an agent can make cost-aware decisions.
No parameters.
list_lighting_effects
List the COM-497 starter lighting effects available to launch as cues (e.g. "gobo-cycle", "x-move", "dimmer-pulse"). Each effect carries an id, the capabilities it needs, and a launch_contract template. Use the returned id as effect_id for launch_lighting_cue.
No parameters.
launch_lighting_cue
Launch a starter lighting effect onto a stage as a live cue (e.g. "gobo-cycle on the stage's 7R beams at speed 0.5"). Pass effect_id (from list_lighting_effects) and optional variables to override effect defaults. Validation is loud: an unknown effect, a launch_contract whose bindings a stage cannot render, or a missing required field is rejected. Returns the active cue including its launch_id, resolved variables, and launch_contract for REACT. REACT executes the cue per-frame; the live strobe slider stays authoritative and is never raised by a launch.
Parameters (4)
stage_idinteger
The stage to launch onto (must belong to the authenticated account)
effect_idstring
COM-497 starter effect id from list_lighting_effects, e.g. "gobo-cycle"
variablesobject
Optional variable overrides (name -> value), e.g. {"speed": 0.5}. Defaults come from the effect.
launch_contractobject
Advanced: an explicit launch_contract to launch instead of resolving one from effect_id.
list_lighting_cues
List the live (non-stopped) lighting cues REACT is executing, including each cue's launch_id, resolved variables, launch_contract, and feedback. Optionally scope to one stage.
Parameters (1)
stage_idinteger
Optional stage id to scope the listing to (must belong to the authenticated account)
get_lighting_cue
Fetch a single live lighting cue by its launch_id, including resolved variables, launch_contract, and REACT feedback.
Parameters (1)
launch_idstringrequired
The launch_id returned by launch_lighting_cue or list_lighting_cues
stop_lighting_cue
Stop a live cue by its launch_id. Idempotent - the cue is marked stop-requested so REACT drops it on its next refresh.
Parameters (1)
launch_idstringrequired
The launch_id of the cue to stop
set_lighting_cue_variables
Update variables on a live cue (e.g. change cycle speed or intensity mid-show). Only the variables you pass change; the rest keep their current values. Stopped cues are rejected.
Parameters (2)
launch_idstringrequired
The launch_id of the cue to update
variablesobjectrequired
Variables to set (name -> value), e.g. {"speed": 0.75}
ack_lighting_cue
REACT/BAE acknowledgement for a launch_id. Idempotently records whether the executor accepted or rejected the cue and which executor observed it.
Parameters (5)
launch_idstringrequired
The launch_id to acknowledge
acceptedbooleanrequired
true when REACT/BAE accepted the cue for execution
rejected_reasonstring
Required by convention when accepted=false
executor_idstring
Stable REACT/BAE executor instance id
observed_atstring
Executor observation timestamp
report_lighting_cue
REACT/BAE report-back for cue status, active variables, skipped bindings, capability misses, last_frame_at, and errors.
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.
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.
