Compeller

ai.compellerPublished by compeller.aiOfficial publisherv0.5.1Updated Nov 3, 2026

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

VerifiedStreamable HTTPWeb executableMedia & DesignAI & ML

Overview

AI-generated overview

Compeller is a hosted MCP server that lets an assistant create, render and track AI music videos and audio-reactive visuals from songs.

What you can do
  • Discover platform capabilities, pricing and available visual styles
  • Search Deezer preview tracks or uploaded media, and get upload instructions for audio, image and video files
  • Create Compels from a track or uploaded audio, list and search jobs, check status and start renders
  • List and inspect video renderings for a Compel
  • Register, update, test, rotate and delete signed webhooks for compel lifecycle events
  • Check render-minute balance and plan, and cancel in-progress jobs
When to use it
Use it when you want an assistant to turn a song or audio file into a rendered music video or audio-reactive visual, and to follow the job through to a finished MP4. Also useful for wiring completion notifications into your own service via signed webhooks.
Requirements
A remote Streamable HTTP endpoint; no local package or runtime. Discovery tools work unauthenticated, but generation, account, media, rendering and webhook tools need a Compeller API token sent as an Authorization Bearer header or the X-API-Token header. A Compeller account is required, and webhook registration needs an HTTPS receiver endpoint.
Before you install
The API token is a secret sent in the Authorization or X-API-Token header. Renders consume paid render minutes, so check the balance before expensive jobs. Creating, rendering, cancelling and webhook changes modify account state. Webhook signing secrets are returned only once on registration or rotation, and rotating invalidates the previous secret immediately. Music search uses Deezer preview tracks, and job data goes to Compeller's hosted service.

Installation

In SourceWeft

  1. Open Compeller in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/ai.compeller%2Fcompel/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "compeller": {
      "type": "http",
      "url": "https://compeller.ai/api/mcp"
    }
  }
}

README

Compeller MCP

Public documentation and metadata for the hosted Compeller MCP server.

Compeller turns music into performance-ready visuals. Agents can discover styles and pricing, search for music, create and track Compels, start renders, retrieve finished videos, and register signed webhooks for completion events.

This repository contains public connector documentation and metadata only. The production Compeller application source code is not published here.

Remote MCP endpoint

text
https://compeller.ai/api/mcp

Quick config

Most MCP clients that support remote Streamable HTTP servers can use:

json
{  "mcpServers": {    "compeller": {      "url": "https://compeller.ai/api/mcp",      "headers": {        "Authorization": "Bearer YOUR_COMPELLER_API_TOKEN"      }    }  }}

If your MCP client stores raw token values without the Bearer prefix, use the alternate header:

json
{  "mcpServers": {    "compeller": {      "url": "https://compeller.ai/api/mcp",      "headers": {        "X-API-Token": "YOUR_COMPELLER_API_TOKEN"      }    }  }}

Discovery works without authentication. Generation, account, media, rendering, and webhook tools require a Compeller API token.

Public docs and discovery

Tool surface

Compeller currently exposes 20 MCP tools:

Discovery

  • get_capabilities
  • get_pricing
  • list_styles
  • search_music

Media and generation

  • upload_media
  • search_media
  • create_compel_from_music
  • create_compel
  • get_compel
  • start_render
  • list_compels
  • search_compels
  • list_renderings
  • get_rendering

Webhooks

  • register_webhook
  • list_webhooks
  • update_webhook
  • delete_webhook
  • test_webhook_delivery
  • rotate_webhook_secret

Webhook deliveries are signed with X-Compeller-Signature: sha256=<hex> over the raw request body. Secrets are returned exactly once on registration or rotation.

Example prompts

  • “Search for Midnight City by M83 and create a cinematic Compeller visual.”
  • “Show me available Compeller visual styles.”
  • “Check the status of Compel 12345.”
  • “Start the render for this READY Compel.”
  • “Register a webhook for completed/failed Compeller events.”

Directory listing copy

Short description:

text
Create AI music videos and audio-reactive visuals from songs through MCP.

Longer description:

text
Compeller is a creator media pipeline for music. The MCP server lets agents discover styles and pricing, search music, create and track Compels, upload media, start renders, retrieve renderings, and register signed webhooks for completion events. Completed renderings can also be loaded into REACT, Compeller's desktop app for live audio-reactive shows.

Suggested tags:

text
AI, Music, Video Generation, Audio Reactive, Creative Tools, MCP, Remote MCP, Generative Art, Creator Tools, Entertainment

License

The documentation and metadata in this repository are published under the MIT License.

Source: README.md at commit 3295876

Tools

30

get_capabilities

Get Compeller capabilities

Get Compeller platform capabilities, supported features, and API version.

Takes no parameters.

get_pricing

Get Compeller pricing

Get current Compeller subscription plans and pricing.

Takes no parameters.

list_styles

List visual styles

List available visual styles for Compeller video generation.

Takes no parameters.

upload_media

Get media upload instructions

Get upload instructions for media files (audio, images, video). Returns the upload URL and required headers. Requires API token authentication.

Parametersnametypemime_type

search_music

Search music previews

Search Deezer preview tracks by song, artist, or album. Use this when the user provides a song string but no MP3/WAV/FLAC file.

Parameterslimitqueryrequired

create_compel_from_music

Create Compel from music search

Create a compel from a selected Deezer preview track. If the user provides an audio file instead, upload that file and use create_compel.

Parametersstyletitletrack_idrequiredaspect_ratioartist_contexttarget_platform

create_compel

Create Compel from uploaded audio

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.

Parametersstyletitlerequiredaspect_ratioartist_contexttarget_platformprimary_media_idrequired

get_compel

Get Compel status

Get the current status, progress, and details of a Compeller generation job.

Parameterscompel_idrequired

start_render

Start Compel render

Start rendering a READY compel with default configuration so an agent can continue to final MP4 without opening the browser UI.

Parameterscompel_idrequired

list_compels

List Compels

List all Compeller generation jobs for the authenticated account, newest first.

Parameterslimitoffset

search_compels

Search Compels

Search Compeller generation jobs by title for the authenticated account.

Parameterslimitqueryrequired

list_renderings

List Compel renderings

List all video renderings for a specific compel.

Parameterscompel_idrequired

get_rendering

Get rendering details

Get details of a specific video rendering.

Parametersrendering_idrequired

search_media

Search uploaded media

Search and list uploaded media files for the authenticated account.

Parameterstypelimitoffset

register_webhook

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 delivery is retried with backoff (up to 6 attempts) and every retry carries the same X-Compeller-Event-Id, so dedupe on it.

Parametersurlrequiredevents

list_webhooks

List webhooks

List all webhook endpoints registered for the authenticated account. Secrets are never returned by this tool.

Takes no parameters.

delete_webhook

Delete webhook

Delete a webhook endpoint by id. Removes the registration and stops future deliveries.

Parameterswebhook_idrequired

test_webhook_delivery

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 verify your integration before relying on compel.completed / compel.failed events.

Parameterswebhook_idrequired

update_webhook

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

Parametersurlactiveeventswebhook_idrequired

rotate_webhook_secret

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.

Parameterswebhook_idrequired

cancel_compel

Cancel a 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.

Parameterscompel_idrequired

get_account_credits

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.

Takes no parameters.

list_lighting_effects

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.

Takes no parameters.

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

Parametersstage_ideffect_idvariableslaunch_contract

list_lighting_cues

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.

Parametersstage_id

get_lighting_cue

Get lighting cue

Fetch a single live lighting cue by its launch_id, including resolved variables, launch_contract, and REACT feedback.

Parameterslaunch_idrequired

stop_lighting_cue

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.

Parameterslaunch_idrequired

set_lighting_cue_variables

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.

Parameterslaunch_idrequiredvariablesrequired

ack_lighting_cue

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.

Parametersacceptedrequiredlaunch_idrequiredexecutor_idobserved_atrejected_reason

report_lighting_cue

Report lighting cue

REACT/BAE report-back for cue status, active variables, skipped bindings, capability misses, last_frame_at, and errors.

Parameterserrorstatuslaunch_idrequiredexecutor_idlast_frame_atactive_variablesskipped_bindingscapability_misses

Version history

1
  1. v0.5.1LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts