mcp server
Compeller
Create and track AI music videos and audio-reactive visuals from songs.
Description as published by the maintainer. Source
- version 0.5.1
- slowing
slowing — Most recent push to the repository was 2026-05-05.
What this server can do
30 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.
ack_lighting_cue(accepted, launch_id, executor_id, observed_at, rejected_reason)- REACT/BAE acknowledgement for a launch_id. Idempotently records whether the executor accepted or rejected the cue and which executor observed it. Required: launch_id, accepted.
cancel_compel(compel_id)- 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. Required: compel_id.
create_compel(style, title, aspect_ratio, artist_context, target_platform, primary_media_id)- 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. Required: title, primary_media_id.
create_compel_from_music(style, title, track_id, aspect_ratio, artist_context, target_platform)- Create a compel from a selected Deezer preview track. If the user provides an audio file instead, upload that file and use create_compel. Required: track_id.
delete_webhook(webhook_id)- Delete a webhook endpoint by id. Removes the registration and stops future deliveries. Required: webhook_id.
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.
get_capabilities- Get Compeller platform capabilities, supported features, and API version.
get_compel(compel_id)- Get the current status, progress, and details of a Compeller generation job. Required: compel_id.
get_lighting_cue(launch_id)- Fetch a single live lighting cue by its launch_id, including resolved variables, launch_contract, and REACT feedback. Required: launch_id.
get_pricing- Get current Compeller subscription plans and pricing.
get_rendering(rendering_id)- Get details of a specific video rendering. Required: rendering_id.
launch_lighting_cue(stage_id, effect_id, variables, launch_contract)- 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.
list_compels(limit, offset)- List all Compeller generation jobs for the authenticated account, newest first.
list_lighting_cues(stage_id)- 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.
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.
list_renderings(compel_id)- List all video renderings for a specific compel. Required: compel_id.
list_styles- List available visual styles for Compeller video generation.
list_webhooks- List all webhook endpoints registered for the authenticated account. Secrets are never returned by this tool.
register_webhook(url, events)- 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. Required: url.
report_lighting_cue(error, status, launch_id, executor_id, last_frame_at, active_variables, skipped_bindings, capability_misses)- REACT/BAE report-back for cue status, active variables, skipped bindings, capability misses, last_frame_at, and errors. Required: launch_id.
rotate_webhook_secret(webhook_id)- 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. Required: webhook_id.
search_compels(limit, query)- Search Compeller generation jobs by title for the authenticated account. Required: query.
search_media(type, limit, offset)- Search and list uploaded media files for the authenticated account.
search_music(limit, query)- Search Deezer preview tracks by song, artist, or album. Use this when the user provides a song string but no MP3/WAV/FLAC file. Required: query.
set_lighting_cue_variables(launch_id, 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. Required: launch_id, variables.
start_render(compel_id)- Start rendering a READY compel with default configuration so an agent can continue to final MP4 without opening the browser UI. Required: compel_id.
stop_lighting_cue(launch_id)- Stop a live cue by its launch_id. Idempotent - the cue is marked stop-requested so REACT drops it on its next refresh. Required: launch_id.
test_webhook_delivery(webhook_id)- 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. Required: webhook_id.
update_webhook(url, active, events, webhook_id)- 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). Required: webhook_id.
upload_media(name, type, mime_type)- Get upload instructions for media files (audio, images, video). Returns the upload URL and required headers. Requires API token authentication.
Last successful function declaration observed on . Source: https://compeller.ai/api/mcp. We list what the server declared; we do not call any of these functions.
Endpoint status observed on . Source: https://compeller.ai/api/mcp.
Signals
These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.
| Signal | Value | What it measures | Window | Observed | Source |
|---|---|---|---|---|---|
| GitHub stars | 1 | Number of GitHub accounts that bookmarked this repository since it was created. It is a bookmark count, not installs, not active users and not quality. | cumulative, all time | GitHub | |
| Last commit | 2026-05-05 | Date of the most recent push to any branch. This is the strongest cheap indicator of whether the project is still maintained. | point in time | GitHub | |
| Open issues | 0 | Open issues plus open pull requests, as GitHub counts them together. A high number can mean an active project or an abandoned one. | as of fetch | GitHub | |
| Latest published version | 0.5.1 | Latest version string the maintainer published to the registry. | as of fetch | Model Context Protocol | |
| Registry record last updated | 2026-05-05 | When the registry record was last updated by its maintainer. | point in time | Model Context Protocol | |
| License | MIT | Licence GitHub detected in the repository. Detection can be wrong; the LICENSE file is authoritative. | as of fetch | GitHub | |
| First listed in the MCP Registry | 2026-05-05 | Date this server was first published to the official MCP Registry. Not a usage or quality measure. | point in time | Model Context Protocol | |
| repository status | active | The repository exists on GitHub and is not archived. This says nothing about how recently it was worked on. | as of fetch | GitHub | |
| mcp tools declared | 30 tools | Number of functions the server itself declared when asked to list them. This is what the server offers an agent, not a measure of how well any of them work. | as of probe | compeller.ai | |
| mcp endpoint status | ok | The server listed 30 functions when asked. | as of probe | compeller.ai |
Where to get it
This record as data
Every field on this page, with its source and observation date, is in the catalog JSON. Fetch the whole kind at once instead of parsing this HTML.
GET /api/v1/entries/mcp_server.json