# compeller

Compeller is a remote MCP connector for live audio-reactive visual workflows, render status tracking, style discovery, and creator media pipeline automation.

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add info-nijd/compeller

# Browse available tools
npx -y smithery tool list info-nijd/compeller

# Get full schema for a tool
npx -y smithery tool get info-nijd/compeller get_capabilities

# Call a tool
npx -y smithery tool call info-nijd/compeller get_capabilities '{}'
```

## Direct MCP Connection

Endpoint: `https://compeller--info-nijd.run.tools`

**Optional config:**
- `X-API-Token` (header) — Compeller API Token

## Tools (20)

- `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 A…
- `search_music` — Search Deezer preview tracks by song, artist, or album. Use this when the user provides a song string but no MP3/WAV/FL…
- `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 …
- `create_compel` — Create a Compeller generation job from primary audio media and optional reference media. Returns compel id, status, and…
- `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 bro…
- `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 terminal events (compel.completed, compel.fa…
- `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…
- `update_webhook` — Update one or more mutable fields on a registered webhook endpoint: url, events, active. At least one of these must be …
- `rotate_webhook_secret` — Mint a new HMAC-SHA256 signing secret for a registered webhook endpoint. The previous secret is invalidated immediately…

```bash
# Get full input/output schema for a tool
npx -y smithery tool get info-nijd/compeller <tool-name>
```
