Connection check
verified live · 20h ago
compel
Create and track AI music videos and audio-reactive visuals from songs.
Tools
30
GitHub stars
—
Installs / wk
—
Licence
—
Transport
streamable-http
Last checked
20h ago
Tools & capabilities
30 toolsRead from the running server on 20h ago.
ack_lighting_cue
accepted*launch_id*executor_idobserved_atrejected_reason
REACT/BAE acknowledgement for a launch_id. Idempotently records whether the executor accepted or rejected the cue and which executor observed it. REACT/BAE acknowledgement for a launch_id. Idempotently records whether the executor accepted or rejected the cue and which executor observed it.
cancel_compel
can modify data
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 alr… 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.
create_compel
styletitle*aspect_ratioartist_contexttarget_platformprimary_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. 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.
create_compel_from_music
styletitletrack_id*aspect_ratioartist_contexttarget_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. Create a compel from a selected Deezer preview track. If the user provides an audio file instead, upload that file and use create_compel.
delete_webhook
can modify data
webhook_id*
Delete a webhook endpoint by id. Removes the registration and stops future deliveries. Delete a webhook endpoint by id. Removes the registration and stops future deliveries.
get_account_credits
read-only
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 starti… 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
read-only
Get Compeller platform capabilities, supported features, and API version. Get Compeller platform capabilities, supported features, and API version.
get_compel
read-only
compel_id*
Get the current status, progress, and details of a Compeller generation job. Get the current status, progress, and details of a Compeller generation job.
get_lighting_cue
read-only
launch_id*
Fetch a single live lighting cue by its launch_id, including resolved variables, launch_contract, and REACT feedback. Fetch a single live lighting cue by its launch_id, including resolved variables, launch_contract, and REACT feedback.
get_pricing
read-only
Get current Compeller subscription plans and pricing. Get current Compeller subscription plans and pricing.
get_rendering
read-only
rendering_id*
Get details of a specific video rendering. Get details of a specific video rendering.
launch_lighting_cue
stage_ideffect_idvariableslaunch_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 varia… 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
read-only
limitoffset
List all Compeller generation jobs for the authenticated account, newest first. List all Compeller generation jobs for the authenticated account, newest first.
list_lighting_cues
read-only
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 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
read-only
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 lau… 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
read-only
compel_id*
List all video renderings for a specific compel. List all video renderings for a specific compel.
list_styles
read-only
List available visual styles for Compeller video generation. List available visual styles for Compeller video generation.
list_webhooks
read-only
List all webhook endpoints registered for the authenticated account. Secrets are never returned by this tool. 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… 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.
report_lighting_cue
errorstatuslaunch_id*executor_idlast_frame_atactive_variables
+2
REACT/BAE report-back for cue status, active variables, skipped bindings, capability misses, last_frame_at, and errors. REACT/BAE report-back for cue status, active variables, skipped bindings, capability misses, last_frame_at, and errors.
rotate_webhook_secret
can modify data
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 com… 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.
search_compels
read-only
limitquery*
Search Compeller generation jobs by title for the authenticated account. Search Compeller generation jobs by title for the authenticated account.
search_media
read-only
typelimitoffset
Search and list uploaded media files for the authenticated account. Search and list uploaded media files for the authenticated account.
search_music
read-only
limitquery*
Search Deezer preview tracks by song, artist, or album. Use this when the user provides a song string but no MP3/WAV/FLAC file. Search Deezer preview tracks by song, artist, or album. Use this when the user provides a song string but no MP3/WAV/FLAC file.
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. 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.
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. Start rendering a READY compel with default configuration so an agent can continue to final MP4 without opening the browser UI.
stop_lighting_cue
can modify data
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. Stop a live cue by its launch_id. Idempotent - the cue is marked stop-requested so REACT drops it on its next refresh.
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 t… 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.
update_webhook
urlactiveeventswebhook_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, <=… 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).
upload_media
read-only
nametypemime_type