Create and track AI music videos and audio-reactive visuals from songs.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
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.
Alternative Compeller API token header. Use this instead of Authorization if your MCP client stores token values without the Bearer prefix.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
REACT/BAE acknowledgement for a launch_id. Idempotently records whether the executor accepted or rejected the cue and which executor observed it.
true when REACT/BAE accepted the cue for execution
The launch_id to acknowledge
Stable REACT/BAE executor instance id
Executor observation timestamp
Required by convention when accepted=false
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
REACT/BAE acknowledgement for a launch_id. Idempotently records whether the executor accepted or rejected the cue and which executor observed it.
| Argument | Type | Description |
|---|---|---|
| accepted* | boolean | true when REACT/BAE accepted the cue for execution |
| launch_id* | string | The launch_id to acknowledge |
| executor_id | string | Stable REACT/BAE executor instance id |
| observed_at | string | Executor observation timestamp |
| rejected_reason | string | Required by convention when accepted=false |
{
"type": "object",
"required": [
"launch_id",
"accepted"
],
"properties": {
"accepted": {
"type": "boolean",
"description": "true when REACT/BAE accepted the cue for execution"
},
"launch_id": {
"type": "string",
"description": "The launch_id to acknowledge"
},
"executor_id": {
"type": "string",
"description": "Stable REACT/BAE executor instance id"
},
"observed_at": {
"type": "string",
"description": "Executor observation timestamp"
},
"rejected_reason": {
"type": "string",
"description": "Required by convention when accepted=false"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| compel_id* | integer | The compel ID to cancel |
{
"type": "object",
"required": [
"compel_id"
],
"properties": {
"compel_id": {
"type": "integer",
"description": "The compel ID to cancel"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| style | string | Visual style. Use one of the exact ids returned by list_styles (e.g. "Cinematic Realistic", "Anime / Manga"). Omit to use the account default. |
| title* | string | Title for the compel |
| aspect_ratio | string | Explicit aspect ratio override (takes precedence over target_platform). |
| artist_context | string | Additional creative context about the artist or song |
| target_platform | string | Target platform; sets the aspect ratio when aspect_ratio is omitted. |
| primary_media_id* | integer | ID of the uploaded audio media to use as the primary track |
{
"type": "object",
"required": [
"title",
"primary_media_id"
],
"properties": {
"style": {
"enum": [
"Cinematic Realistic",
"Photo Realistic",
"Cyberpunk",
"Anime / Manga",
"Film Noir",
"Watercolor Painting",
"Oil Painting",
"3D Render / Pixar",
"Retro 80s Synthwave",
"Vintage Film Grain",
"Comic Book / Pop Art",
"Fantasy / Ethereal",
"Horror / Dark Gothic",
"Steampunk",
"Neon Glow",
"Minimalist / Abstract",
"Surrealist",
"Documentary",
"Vaporwave",
"Pencil Sketch",
"Noir Detective",
"Claymation / Stop Motion",
"Studio Ghibli",
"Baroque / Renaissance",
"Lo-Fi / Grainy VHS",
"Glitch Art / Digital",
"Psychedelic"
],
"type": "string",
"description": "Visual style. Use one of the exact ids returned by list_styles (e.g. \"Cinematic Realistic\", \"Anime / Manga\"). Omit to use the account default."
},
"title": {
"type": "string",
"description": "Title for the compel"
},
"aspect_ratio": {
"enum": [
"16:9",
"9:16",
"1:1"
],
"type": "string",
"description": "Explicit aspect ratio override (takes precedence over target_platform)."
},
"artist_context": {
"type": "string",
"description": "Additional creative context about the artist or song"
},
"target_platform": {
"enum": [
"tiktok",
"reels",
"shorts",
"instagram",
"square",
"youtube",
"web"
],
"type": "string",
"description": "Target platform; sets the aspect ratio when aspect_ratio is omitted."
},
"primary_media_id": {
"type": "integer",
"description": "ID of the uploaded audio media to use as the primary track"
}
}
}Create a compel from a selected Deezer preview track. If the user provides an audio file instead, upload that file and use create_compel.
| Argument | Type | Description |
|---|---|---|
| style | string | Visual style. Use one of the exact ids returned by list_styles (e.g. "Cinematic Realistic", "Anime / Manga"). Omit to use the account default. |
| title | string | Optional compel title override |
| track_id* | integer | Deezer track id returned by search_music |
| aspect_ratio | string | Explicit aspect ratio override (takes precedence over target_platform). |
| artist_context | string | Additional creative context |
| target_platform | string | Target platform; sets the aspect ratio when aspect_ratio is omitted. |
{
"type": "object",
"required": [
"track_id"
],
"properties": {
"style": {
"enum": [
"Cinematic Realistic",
"Photo Realistic",
"Cyberpunk",
"Anime / Manga",
"Film Noir",
"Watercolor Painting",
"Oil Painting",
"3D Render / Pixar",
"Retro 80s Synthwave",
"Vintage Film Grain",
"Comic Book / Pop Art",
"Fantasy / Ethereal",
"Horror / Dark Gothic",
"Steampunk",
"Neon Glow",
"Minimalist / Abstract",
"Surrealist",
"Documentary",
"Vaporwave",
"Pencil Sketch",
"Noir Detective",
"Claymation / Stop Motion",
"Studio Ghibli",
"Baroque / Renaissance",
"Lo-Fi / Grainy VHS",
"Glitch Art / Digital",
"Psychedelic"
],
"type": "string",
"description": "Visual style. Use one of the exact ids returned by list_styles (e.g. \"Cinematic Realistic\", \"Anime / Manga\"). Omit to use the account default."
},
"title": {
"type": "string",
"description": "Optional compel title override"
},
"track_id": {
"type": "integer",
"description": "Deezer track id returned by search_music"
},
"aspect_ratio": {
"enum": [
"16:9",
"9:16",
"1:1"
],
"type": "string",
"description": "Explicit aspect ratio override (takes precedence over target_platform)."
},
"artist_context": {
"type": "string",
"description": "Additional creative context"
},
"target_platform": {
"enum": [
"tiktok",
"reels",
"shorts",
"instagram",
"square",
"youtube",
"web"
],
"type": "string",
"description": "Target platform; sets the aspect ratio when aspect_ratio is omitted."
}
}
}Delete a webhook endpoint by id. Removes the registration and stops future deliveries.
| Argument | Type | Description |
|---|---|---|
| webhook_id* | integer | The webhook id returned by register_webhook or list_webhooks |
{
"type": "object",
"required": [
"webhook_id"
],
"properties": {
"webhook_id": {
"type": "integer",
"description": "The webhook id returned by register_webhook or list_webhooks"
}
}
}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.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Get Compeller platform capabilities, supported features, and API version.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Get the current status, progress, and details of a Compeller generation job.
| Argument | Type | Description |
|---|---|---|
| compel_id* | integer | The compel ID to check |
{
"type": "object",
"required": [
"compel_id"
],
"properties": {
"compel_id": {
"type": "integer",
"description": "The compel ID to check"
}
}
}Fetch a single live lighting cue by its launch_id, including resolved variables, launch_contract, and REACT feedback.
| Argument | Type | Description |
|---|---|---|
| launch_id* | string | The launch_id returned by launch_lighting_cue or list_lighting_cues |
{
"type": "object",
"required": [
"launch_id"
],
"properties": {
"launch_id": {
"type": "string",
"description": "The launch_id returned by launch_lighting_cue or list_lighting_cues"
}
}
}Get current Compeller subscription plans and pricing.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}Get details of a specific video rendering.
| Argument | Type | Description |
|---|---|---|
| rendering_id* | integer | The rendering ID to retrieve |
{
"type": "object",
"required": [
"rendering_id"
],
"properties": {
"rendering_id": {
"type": "integer",
"description": "The rendering ID to retrieve"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| stage_id | integer | The stage to launch onto (must belong to the authenticated account) |
| effect_id | string | COM-497 starter effect id from list_lighting_effects, e.g. "gobo-cycle" |
| variables | object | Optional variable overrides (name -> value), e.g. {"speed": 0.5}. Defaults come from the effect. |
| launch_contract | object | Advanced: an explicit launch_contract to launch instead of resolving one from effect_id. |
{
"type": "object",
"required": [],
"properties": {
"stage_id": {
"type": "integer",
"description": "The stage to launch onto (must belong to the authenticated account)"
},
"effect_id": {
"type": "string",
"description": "COM-497 starter effect id from list_lighting_effects, e.g. \"gobo-cycle\""
},
"variables": {
"type": "object",
"description": "Optional variable overrides (name -> value), e.g. {\"speed\": 0.5}. Defaults come from the effect."
},
"launch_contract": {
"type": "object",
"description": "Advanced: an explicit launch_contract to launch instead of resolving one from effect_id."
}
}
}List all Compeller generation jobs for the authenticated account, newest first.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results to return (default 20, max 100) |
| offset | integer | Pagination offset |
{
"type": "object",
"required": [],
"properties": {
"limit": {
"type": "integer",
"description": "Max results to return (default 20, max 100)"
},
"offset": {
"type": "integer",
"description": "Pagination offset"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| stage_id | integer | Optional stage id to scope the listing to (must belong to the authenticated account) |
{
"type": "object",
"required": [],
"properties": {
"stage_id": {
"type": "integer",
"description": "Optional stage id to scope the listing to (must belong to the authenticated account)"
}
}
}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.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}List all video renderings for a specific compel.
| Argument | Type | Description |
|---|---|---|
| compel_id* | integer | The compel ID to list renderings for |
{
"type": "object",
"required": [
"compel_id"
],
"properties": {
"compel_id": {
"type": "integer",
"description": "The compel ID to list renderings for"
}
}
}List available visual styles for Compeller video generation.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}List all webhook endpoints registered for the authenticated account. Secrets are never returned by this tool.
No arguments.
{
"type": "object",
"required": [],
"properties": {}
}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.
| Argument | Type | Description |
|---|---|---|
| url* | string | HTTPS URL to deliver events to (max 2048 chars) |
| events | array | Event types to subscribe to. Omit or pass ["*"] for all. Known types: compel.ready (renderable - call start_render), compel.completed, compel.failed. |
{
"type": "object",
"required": [
"url"
],
"properties": {
"url": {
"type": "string",
"description": "HTTPS URL to deliver events to (max 2048 chars)"
},
"events": {
"type": "array",
"items": {
"enum": [
"*",
"compel.ready",
"compel.completed",
"compel.failed"
],
"type": "string"
},
"description": "Event types to subscribe to. Omit or pass [\"*\"] for all. Known types: compel.ready (renderable - call start_render), compel.completed, compel.failed."
}
}
}REACT/BAE report-back for cue status, active variables, skipped bindings, capability misses, last_frame_at, and errors.
| Argument | Type | Description |
|---|---|---|
| error | string | |
| status | string | ACTIVE, STOP_REQUESTED, or STOPPED |
| launch_id* | string | The launch_id to report |
| executor_id | string | |
| last_frame_at | string | |
| active_variables | object | Variables actually being sampled by REACT/BAE |
| skipped_bindings | array | |
| capability_misses | array |
{
"type": "object",
"required": [
"launch_id"
],
"properties": {
"error": {
"type": "string"
},
"status": {
"type": "string",
"description": "ACTIVE, STOP_REQUESTED, or STOPPED"
},
"launch_id": {
"type": "string",
"description": "The launch_id to report"
},
"executor_id": {
"type": "string"
},
"last_frame_at": {
"type": "string"
},
"active_variables": {
"type": "object",
"description": "Variables actually being sampled by REACT/BAE"
},
"skipped_bindings": {
"type": "array",
"items": {
"type": "string"
}
},
"capability_misses": {
"type": "array",
"items": {
"type": "object"
}
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| webhook_id* | integer | The webhook id to rotate the secret on |
{
"type": "object",
"required": [
"webhook_id"
],
"properties": {
"webhook_id": {
"type": "integer",
"description": "The webhook id to rotate the secret on"
}
}
}Search Compeller generation jobs by title for the authenticated account.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results to return (default 20) |
| query* | string | Search query to match against compel titles |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"description": "Max results to return (default 20)"
},
"query": {
"type": "string",
"description": "Search query to match against compel titles"
}
}
}Search and list uploaded media files for the authenticated account.
| Argument | Type | Description |
|---|---|---|
| type | string | Filter by media type: audio, image, video, or text |
| limit | integer | Max results to return (default 20, max 100) |
| offset | integer | Pagination offset |
{
"type": "object",
"required": [],
"properties": {
"type": {
"type": "string",
"description": "Filter by media type: audio, image, video, or text"
},
"limit": {
"type": "integer",
"description": "Max results to return (default 20, max 100)"
},
"offset": {
"type": "integer",
"description": "Pagination offset"
}
}
}Search Deezer preview tracks by song, artist, or album. Use this when the user provides a song string but no MP3/WAV/FLAC file.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Max results to return (default 10, max 20) |
| query* | string | Song, artist, or album search query |
{
"type": "object",
"required": [
"query"
],
"properties": {
"limit": {
"type": "integer",
"description": "Max results to return (default 10, max 20)"
},
"query": {
"type": "string",
"description": "Song, artist, or album search query"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| launch_id* | string | The launch_id of the cue to update |
| variables* | object | Variables to set (name -> value), e.g. {"speed": 0.75} |
{
"type": "object",
"required": [
"launch_id",
"variables"
],
"properties": {
"launch_id": {
"type": "string",
"description": "The launch_id of the cue to update"
},
"variables": {
"type": "object",
"description": "Variables to set (name -> value), e.g. {\"speed\": 0.75}"
}
}
}Start rendering a READY compel with default configuration so an agent can continue to final MP4 without opening the browser UI.
| Argument | Type | Description |
|---|---|---|
| compel_id* | integer | The READY compel ID to render |
{
"type": "object",
"required": [
"compel_id"
],
"properties": {
"compel_id": {
"type": "integer",
"description": "The READY compel ID to render"
}
}
}Stop a live cue by its launch_id. Idempotent - the cue is marked stop-requested so REACT drops it on its next refresh.
| Argument | Type | Description |
|---|---|---|
| launch_id* | string | The launch_id of the cue to stop |
{
"type": "object",
"required": [
"launch_id"
],
"properties": {
"launch_id": {
"type": "string",
"description": "The launch_id of the cue to stop"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| webhook_id* | integer | The webhook id to test. Must belong to the authenticated account. |
{
"type": "object",
"required": [
"webhook_id"
],
"properties": {
"webhook_id": {
"type": "integer",
"description": "The webhook id to test. Must belong to the authenticated account."
}
}
}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).
| Argument | Type | Description |
|---|---|---|
| url | string | New HTTPS URL (max 2048 chars) |
| active | boolean | Toggle delivery on/off without losing the registration |
| events | array | Replacement event types. Omit to leave unchanged. ["*"] or an empty filtered list resets to wildcard. |
| webhook_id* | integer | The webhook id to update |
{
"type": "object",
"required": [
"webhook_id"
],
"properties": {
"url": {
"type": "string",
"description": "New HTTPS URL (max 2048 chars)"
},
"active": {
"type": "boolean",
"description": "Toggle delivery on/off without losing the registration"
},
"events": {
"type": "array",
"items": {
"enum": [
"*",
"compel.ready",
"compel.completed",
"compel.failed"
],
"type": "string"
},
"description": "Replacement event types. Omit to leave unchanged. [\"*\"] or an empty filtered list resets to wildcard."
},
"webhook_id": {
"type": "integer",
"description": "The webhook id to update"
}
}
}Get upload instructions for media files (audio, images, video). Returns the upload URL and required headers. Requires API token authentication.
| Argument | Type | Description |
|---|---|---|
| name | string | Filename for the upload |
| type | string | Media type: audio, image, video, or text |
| mime_type | string | MIME type of the file |
{
"type": "object",
"required": [],
"properties": {
"name": {
"type": "string",
"description": "Filename for the upload"
},
"type": {
"type": "string",
"description": "Media type: audio, image, video, or text"
},
"mime_type": {
"type": "string",
"description": "MIME type of the file"
}
}
}