ai.compeller/compel · v0.5.1 · ai-and-media
Compeller is healthy: it completed an MCP handshake in 1504 ms and exposes 30 tools. It scores 61/100.
Create and track AI music videos and audio-reactive visuals from songs.
Endpoint: https://compeller.ai/api/mcp (streamable-http)
Repository · JSON · Add to my inventory
| health | 20 / 25 |
| authEase | 15 / 15 |
| toolQuality | 15 / 15 |
| maintenance | 3 / 15 |
| adoption | 0 / 10 |
| usage | 0 / 10 |
| security | 8 / 10 |
Scoring v0.3, computed 2026-10-14T14:16:22.083Z.
| Checked (UTC) | Status | Latency | Error |
|---|---|---|---|
| 2026-10-14T08:59:58.308Z | Healthy | 1504 |
get_capabilities | Get Compeller platform capabilities, supported features, and API version. |
get_pricing | Get current Compeller subscription plans and pricing. |
list_styles | List available visual styles for Compeller video generation. |
upload_media | Get upload instructions for media files (audio, images, video). Returns the upload URL and required headers. Requires API token authentication. |
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. |
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. |
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. |
get_compel | Get the current status, progress, and details of a Compeller generation job. |
start_render | Start rendering a READY compel with default configuration so an agent can continue to final MP4 without opening the browser UI. |
list_compels | List all Compeller generation jobs for the authenticated account, newest first. |
search_compels | Search Compeller generation jobs by title for the authenticated account. |
list_renderings | List all video renderings for a specific compel. |
get_rendering | Get details of a specific video rendering. |
search_media | Search and list uploaded media files for the authenticated account. |
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 s |
list_webhooks | List all webhook endpoints registered for the authenticated account. Secrets are never returned by this tool. |
delete_webhook | Delete a webhook endpoint by id. Removes the registration and stops future deliveries. |
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 |
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_web |
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. |
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. |
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. |
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. |
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 |
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. |
get_lighting_cue | Fetch a single live lighting cue by its launch_id, including resolved variables, launch_contract, and REACT feedback. |
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. |
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. |
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. |
report_lighting_cue | REACT/BAE report-back for cue status, active variables, skipped bindings, capability misses, last_frame_at, and errors. |