Compeller
Create and track AI music videos and audio-reactive visuals from songs.
| Endpoint | https://compeller.ai/api/mcp (streamable-http) |
|---|---|
| Registry version | 0.5.1 |
| Now | 30 tools · grade D (64) · pin ts_efb95aba4299a1d34451d63bbaacf693 · protocol 2024-11-05 |
| First / last listed | 2026-10-27 07:43 UTC / 2026-10-27 07:43 UTC |
| Grade over time | 2026-10-27: D (64), 30 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: 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
get_capabilities | Get Compeller platform capabilities, supported features, and API version. params: none |
get_pricing | Get current Compeller subscription plans and pricing. params: none |
list_styles | List available visual styles for Compeller video generation. params: none |
upload_media | Get upload instructions for media files (audio, images, video). Returns the upload URL and required headers. Requires API token authentication. params: name, mime_type, type |
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. params: query*, limit |
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. params: track_id*, title, style, target_platform, aspect_ratio, artist_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. params: title*, primary_media_id*, style, target_platform, aspect_ratio, artist_context |
get_compel | Get the current status, progress, and details of a Compeller generation job. params: compel_id* |
start_render | Start rendering a READY compel with default configuration so an agent can continue to final MP4 without opening the browser UI. params: compel_id* |
list_compels | List all Compeller generation jobs for the authenticated account, newest first. params: limit, offset |
search_compels | Search Compeller generation jobs by title for the authenticated account. params: query*, limit |
list_renderings | List all video renderings for a specific compel. params: compel_id* |
get_rendering | Get details of a specific video rendering. params: rendering_id* |
search_media | Search and list uploaded media files for the authenticated account. params: type, limit, 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 params: url*, events |
list_webhooks | List all webhook endpoints registered for the authenticated account. Secrets are never returned by this tool. params: none |
delete_webhook | Delete a webhook endpoint by id. Removes the registration and stops future deliveries. params: webhook_id* |
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 veri params: webhook_id* |
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). params: webhook_id*, url, events, active |
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. params: webhook_id* |
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. params: compel_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. params: none |
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. params: none |
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, re params: stage_id, effect_id, variables, launch_contract |
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. params: stage_id |
get_lighting_cue | Fetch a single live lighting cue by its launch_id, including resolved variables, launch_contract, and REACT feedback. params: launch_id* |
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. params: launch_id* |
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. params: launch_id*, variables* |
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. params: launch_id*, accepted*, rejected_reason, executor_id, observed_at |
report_lighting_cue | REACT/BAE report-back for cue status, active variables, skipped bindings, capability misses, last_frame_at, and errors. params: launch_id*, status, active_variables, skipped_bindings, capability_misses, last_frame_at, error, executor_id |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.