NestDaddy

Compeller

ai.compeller/compel · v0.5.1

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

Connect Remote server

Terminal
claude mcp add --transport http compel https://compeller.ai/api/mcp --header "Authorization: Bearer <YOUR_API_KEY>" --header "X-API-Token: <X_API_TOKEN>"
~/.cursor/mcp.json
{
  "mcpServers": {
    "compel": {
      "url": "https://compeller.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>",
        "X-API-Token": "<X_API_TOKEN>"
      }
    }
  }
}
.vscode/mcp.json
{
  "servers": {
    "compel": {
      "type": "http",
      "url": "https://compeller.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_API_KEY>",
        "X-API-Token": "<X_API_TOKEN>"
      }
    }
  }
}
Claude Desktop
Settings > Connectors > Add custom connector
URL: https://compeller.ai/api/mcp

Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.

Tools 30 found in our last check

  • 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 ag…

  • 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_previ…

  • 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…

  • 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 r…

  • 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 bi…

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

Headers

NameDescription
Authorization
Optional, secret
Bearer token from Compeller Account → API Access, POST /api/login, or POST /api/v1/auth/token. Discovery tools work without this header; generation/account tools require it.
X-API-Token
Optional, secret
Alternative Compeller API token header. Use this instead of Authorization if your MCP client stores token values without the Bearer prefix.

Details

Endpointhttps://compeller.ai/api/mcp (Streamable HTTP)
First published5 May 2026
Last updated5 May 2026
Registry nameai.compeller/compel

More ai and media servers See all

Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.