How do I install Compeller?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Compeller need an API key?

No required environment variable is listed on this record.

What transport does Compeller use?

Compeller is reached over HTTP.

When was Compeller last checked?

Last checked 2026-10-21. Create and track AI music videos and audio-reactive visuals from songs.

Compeller MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://compeller.ai/api/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http ai.compeller-compel https://compeller.ai/api/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "ai.compeller-compel": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://compeller.ai/api/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 0.5.1
Last checked

30 tools

Tools

tools/listVoice mode preview

Tool	What it does
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.

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

https://compeller.ai/api/mcp

Namespace: ai.compeller/compel
Server: compeller-mcp
Version: 0.5.0
Transport: Streamable HTTP JSON-RPC over HTTPS
Official MCP Registry: https://registry.modelcontextprotocol.io/v0.1/servers?search=ai.compeller%2Fcompel
Smithery: https://smithery.ai/servers/info-nijd/compeller

Quick config

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

{
  "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:

{
  "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

MCP docs: https://compeller.ai/api/mcp/docs.md
Agent manifest: https://compeller.ai/agents.json
LLM guide: https://compeller.ai/llms.txt
OpenAPI: https://compeller.ai/api/v1/openapi.yaml
Health: https://compeller.ai/api/v1/health

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:

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

Longer description:

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:

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.

Compeller

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Compeller?

Does Compeller need an API key?

What transport does Compeller use?

When was Compeller last checked?

Documentation

Compeller MCP

Remote MCP endpoint

Quick config

Public docs and discovery

Tool surface

Discovery

Media and generation

Webhooks

Example prompts

Directory listing copy

License