Compeller MCP server

online · 96% uptime

by compeller.ai·ai.compeller/compel·v0.5.1·1 stars

No reviews yet

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

B76/100grade B

Write a review Run it

What users say

No reviews yet

Be the first

Safety scan

B76/100

full report

Adoption

New

1 stars

Reviews

Write one

Nobody has reviewed Compeller yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Compeller tools (30, 7 write)

write = sends, deletes, buys or posts

ack_lighting_cueFree
REACT/BAE acknowledgement for a launch_id. Idempotently records whether the executor accepted or rejected the cue and which executor observed it.
cancel_compelwrite actionFree
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_compelwrite actionFree
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_musicwrite actionFree
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_webhookwrite actionFree
Delete a webhook endpoint by id. Removes the registration and stops future deliveries.
get_account_creditsFree
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_capabilitiesFree
Get Compeller platform capabilities, supported features, and API version.
get_compelFree
Get the current status, progress, and details of a Compeller generation job.
get_lighting_cueFree
Fetch a single live lighting cue by its launch_id, including resolved variables, launch_contract, and REACT feedback.
get_pricingFree
Get current Compeller subscription plans and pricing.
get_renderingFree
Get details of a specific video rendering.
launch_lighting_cueFree
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_compelsFree
List all Compeller generation jobs for the authenticated account, newest first.
list_lighting_cuesFree
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_effectsFree
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_renderingsFree
List all video renderings for a specific compel.
list_stylesFree
List available visual styles for Compeller video generation.
list_webhooksFree
List all webhook endpoints registered for the authenticated account. Secrets are never returned by this tool.
register_webhookFree
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_cueFree
REACT/BAE report-back for cue status, active variables, skipped bindings, capability misses, last_frame_at, and errors.
rotate_webhook_secretFree
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_compelsFree
Search Compeller generation jobs by title for the authenticated account.
search_mediaFree
Search and list uploaded media files for the authenticated account.
search_musicFree
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_variableswrite actionFree
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_renderFree
Start rendering a READY compel with default configuration so an agent can continue to final MP4 without opening the browser UI.
stop_lighting_cueFree
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_deliveryFree
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_webhookwrite actionFree
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_mediawrite actionFree
Get upload instructions for media files (audio, images, video). Returns the upload URL and required headers. Requires API token authentication.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings

–Code scanremote-only server, no package to scann/a
Live reliabilityremote reachable in 646ms20/20
Tool poisoning30 tool descriptions checked15/15
Auth qualityAPI key sent as a header8/15
Maintenancelast push 146 days ago8/15
Maintainer identitynamespace and repository owner differ; GitHub account older than a year6/10

Overall 76/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Compeller compares

Against every graded Media MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 76/100; higher than 48% of 1,337 Media servers
Tools: 30; the typical Media server has 7
Tools that change things: 23%; typical: 4%. Fewer write tools means less an agent can break
Uptime: 96%; of our recent checks; the typical remote Media server answers 100%
Response time: 603 ms; faster than 25% of 862 Media servers
GitHub stars: 1; more than 55% of 715 Media servers

What its tools let an agent do: 20 read · 4 create · 2 change · 2 delete · 2 run or deploy

Install Compeller in Claude Code, Cursor or VS Code

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

Add to Cursor

What the publisher says

From the Compeller repository's README, as published. We do not edit it. Read it on GitHub

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:
Smithery:

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:
Agent manifest:
LLM guide:
OpenAPI:
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
createcompelfrom_music
create_compel
get_compel
start_render
list_compels
search_compels
list_renderings
get_rendering

Webhooks

register_webhook
list_webhooks
update_webhook
delete_webhook
testwebhookdelivery
rotatewebhooksecret

Webhook deliveries are signed with X-Compeller-Signature: sha256= 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.

Nothing above is checked by us. What we check is on the safety report.

Compeller: common questions

Is Compeller MCP server safe?: Mostly: it is graded B (76/100). Read the Compeller safety report
How do I install Compeller?: It runs remotely at compeller.ai. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
Does Compeller need an API key?: Yes. The registry entry asks for Authorization, X-API-Token.
Is Compeller maintained?: The last commit was 183 days ago (2026-05-05). The latest release is v0.5.1.
Is Compeller up?: 96% of our last 28 checks got an answer. We check remote servers about four times a day.
What can I use instead of Compeller?: Servers from other publishers that do the same job: Aetherwave MCP server, FFmpeg MCP server and Transloadit Media Processing MCP server.
How does Compeller compare with other Media MCP servers?: safety score 76/100 (higher than 48% of 1,337 Media servers); tools 30 (the typical Media server has 7); tools that change things 23% (typical: 4%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Compeller

Same job from other publishers: the closest match first, then the best rated.

Aetherwave
Music, image, video and audio generation across top AI providers - one key, one credit pool.
not reviewed
Growing
B
FFmpeg
Trim, convert, resize, compress, and remix audio and video.
not reviewed
Established
A
Transloadit Media Processing
Process video, audio, images and documents with Transloadit Robots. Connect by URL with OAuth.
not reviewed
Established
A
anymd
Any file → clean Markdown for AI agents: PDF, Office, EPUB, HTML, images, audio/video. Local MCP.
not reviewed
Established
A
Sonilo Music & Sound Effects
Licensed soundtracks and sound effects matched to your video. Commercial use OK.
not reviewed
Established
B

Run it through the gateway

With the gateway added, ask your agent for it by name:

agent prompt

call ai.compeller/compel → ack_lighting_cue

Free per call. Metered, capped by your key, logged for reliability.

Add the gateway (gw.mcp.market)

Rating: —
Safety grade: B · 76/100
Stars: 1
Downloads/wk: –
Price: Free
Licence: MIT
Transport: Remote
Uptime: 96% · 27/28 checks
Version: 0.5.1
Category: Media
Last release: 2026-05-05

Endpoint

https://compeller.ai/api/mcp

streamable-http

Own this server?

Claim it to keep the listing current and reply to reviews. Claiming never changes the grade or hides a review.

Claim listing

Badge for your README

Shows the safety grade and links back to this page. It updates itself after every scan and review.

[![mcp.market](https://mcp.market/badge/compeller-compel.svg)](https://mcp.market/server/compeller-compel)

How the badge works