# Compeller MCP server

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

## Links
- Registry page: https://www.getdrio.com/mcp/ai-compeller-compel
- Repository: https://github.com/Compellerai/compeller-mcp

## Install
- Endpoint: https://compeller.ai/api/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: Authorization (secret)
- Remote header: X-API-Token (secret)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://compeller.ai/api/mcp
- Header: Authorization
- Header: X-API-Token

## Tools
- get_capabilities - Get Compeller platform capabilities, supported features, and API version. Endpoint: https://compeller.ai/api/mcp
- get_pricing - Get current Compeller subscription plans and pricing. Endpoint: https://compeller.ai/api/mcp
- list_styles - List available visual styles for Compeller video generation. Endpoint: https://compeller.ai/api/mcp
- upload_media - Get upload instructions for media files (audio, images, video). Returns the upload URL and required headers. Requires API token authentication. Endpoint: https://compeller.ai/api/mcp
- 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. Endpoint: https://compeller.ai/api/mcp
- 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. Endpoint: https://compeller.ai/api/mcp
- 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. Endpoint: https://compeller.ai/api/mcp
- get_compel - Get the current status, progress, and details of a Compeller generation job. Endpoint: https://compeller.ai/api/mcp
- start_render - Start rendering a READY compel with default configuration so an agent can continue to final MP4 without opening the browser UI. Endpoint: https://compeller.ai/api/mcp
- list_compels - List all Compeller generation jobs for the authenticated account, newest first. Endpoint: https://compeller.ai/api/mcp
- search_compels - Search Compeller generation jobs by title for the authenticated account. Endpoint: https://compeller.ai/api/mcp
- list_renderings - List all video renderings for a specific compel. Endpoint: https://compeller.ai/api/mcp
- get_rendering - Get details of a specific video rendering. Endpoint: https://compeller.ai/api/mcp
- search_media - Search and list uploaded media files for the authenticated account. Endpoint: https://compeller.ai/api/mcp
- register_webhook - Register an HTTPS endpoint to receive signed push notifications for compel terminal events (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. Endpoint: https://compeller.ai/api/mcp
- list_webhooks - List all webhook endpoints registered for the authenticated account. Secrets are never returned by this tool. Endpoint: https://compeller.ai/api/mcp
- delete_webhook - Delete a webhook endpoint by id. Removes the registration and stops future deliveries. Endpoint: https://compeller.ai/api/mcp
- 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. Endpoint: https://compeller.ai/api/mcp
- 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). Endpoint: https://compeller.ai/api/mcp
- 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. Endpoint: https://compeller.ai/api/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: ai.compeller
- Version: 0.5.1
- Runtime: Streamable Http
- Transports: HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: May 5, 2026
- Source: https://registry.modelcontextprotocol.io