// MCP TOOL REFERENCE

COMPELLER TOOLS

30 tools from the Compeller MCP Server, categorised by risk level.

View the Compeller policy → Token cost: 3,474 tokens →

// ALL 30 COMPELLER TOOLS

READ 18 tools

Read ack_lighting_cue REACT/BAE acknowledgement for a launch_id. Idempotently records whether the executor accepted or rejected t... Read get_account_credits Get the authenticated account's render-minute balance and plan: minutes remaining (free + paid), monthly al... Read get_capabilities Get Compeller platform capabilities, supported features, and API version. Read get_compel Get the current status, progress, and details of a Compeller generation job. Read get_lighting_cue Fetch a single live lighting cue by its launch_id, including resolved variables, launch_contract, and REACT... Read get_pricing Get current Compeller subscription plans and pricing. Read get_rendering Get details of a specific video rendering. Read list_compels List all Compeller generation jobs for the authenticated account, newest first. Read list_lighting_cues List the live (non-stopped) lighting cues REACT is executing, including each cue's launch_id, resolved vari... Read list_lighting_effects List the COM-497 starter lighting effects available to launch as cues (e.g. "gobo-cycle", "x-move", "dimmer... Read list_renderings List all video renderings for a specific compel. Read list_styles List available visual styles for Compeller video generation. Read list_webhooks List all webhook endpoints registered for the authenticated account. Secrets are never returned by this tool. Read report_lighting_cue REACT/BAE report-back for cue status, active variables, skipped bindings, capability misses, last_frame_at,... Read search_compels Search Compeller generation jobs by title for the authenticated account. Read search_media Search and list uploaded media files for the authenticated account. Read search_music Search Deezer preview tracks by song, artist, or album. Use this when the user provides a song string but n... Read test_webhook_delivery Synchronously POST a synthetic webhook.test event to a registered endpoint. Uses the same HMAC-SHA256 signa...

WRITE 7 tools

Write create_compel Create a Compeller generation job from primary audio media and optional reference media. Returns compel id,... Write create_compel_from_music Create a compel from a selected Deezer preview track. If the user provides an audio file instead, upload th... Write register_webhook Register an HTTPS endpoint to receive signed push notifications for compel lifecycle events (compel.ready w... Write rotate_webhook_secret Mint a new HMAC-SHA256 signing secret for a registered webhook endpoint. The previous secret is invalidated... Write set_lighting_cue_variables Update variables on a live cue (e.g. change cycle speed or intensity mid-show). Only the variables you pass... Write update_webhook Update one or more mutable fields on a registered webhook endpoint: url, events, active. At least one of th... Write upload_media Get upload instructions for media files (audio, images, video). Returns the upload URL and required headers...

DESTRUCTIVE 2 tools

Destructive cancel_compel Cancel an in-progress compel. Dequeues it if still queued, otherwise cancels any active external (AI provid... Destructive delete_webhook Delete a webhook endpoint by id. Removes the registration and stops future deliveries.

EXECUTE 3 tools

Execute 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 sp... Execute start_render Start rendering a READY compel with default configuration so an agent can continue to final MP4 without ope... Execute stop_lighting_cue Stop a live cue by its launch_id. Idempotent - the cue is marked stop-requested so REACT drops it on its ne...

// FAQ

How many tools does the Compeller MCP server have? +

The Compeller MCP server exposes 30 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Compeller tools? +

Route the Compeller server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Compeller tools fall into? +

Compeller tools are categorised as Read (18), Write (7), Destructive (2), Execute (3). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.