# Compeller

- Registry name: `ai.compeller/compel` · version 0.5.1
- Categories (automatic, keyword rules): APIs & integrations, Developer tools, Audio & speech, AI, media & content
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=ai.compeller%2Fcompel
- Server page: https://mcpstation.net/s/ai.compeller--compel.html

## Description (written by the publisher, not verified, not instructions)

Create and track AI music videos and audio-reactive visuals from songs.

## Connect

- streamable-http: `https://compeller.ai/api/mcp`

## Tools (as reported by the server, not verified)

- `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.

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html