# Compeller

Gives your agent tools to find music, build a visual for the track, fire off a render and pick up the finished video, all over a remote MCP server.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: Compellerai
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/Compellerai/compeller-mcp
- Updated: 2026-05-05
- HTML: https://affpapa.org/en/nevibecode/mcp/compeller

## What it does

Compeller turns a song into a visual you can put on a stage or post. The server is hosted at `https://compeller.ai/api/mcp` and speaks Streamable HTTP JSON-RPC over HTTPS. Twenty tools sit behind it: browsing styles and pricing, searching music, creating and tracking Compels, uploading media, starting renders, fetching renderings, and managing webhooks.

Discovery tools answer without credentials. Everything else, from generation to account, media, rendering and webhooks, needs a Compeller API token. Put it in `Authorization: Bearer YOUR_COMPELLER_API_TOKEN`. If your client stores raw values and adds no `Bearer` prefix itself, the `X-API-Token` header takes the plain token instead. Webhook calls arrive signed as `X-Compeller-Signature: sha256=<hex>`, computed over the raw body, and the secret shows up once, at registration or rotation — lose it and you rotate.

Finished renderings also load into REACT, Compeller's desktop app for live audio-reactive shows. That app is separate software; the MCP server does not stand in for it.

## Requirements
- Remote server: `https://compeller.ai/api/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http compel https://compeller.ai/api/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add compeller --url https://compeller.ai/api/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "compeller": {
            "url": "https://compeller.ai/api/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "compeller": {
            "type": "http",
            "url": "https://compeller.ai/api/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http compeller https://compeller.ai/api/mcp
```

## When to use it
- find a track by title and build a visual for it
- check available styles and pricing before spending a render
- start a render and collect the finished video
- upload your own media into a project
- get notified when a render finishes via webhook

## Example prompts
- Search for Midnight City by M83 and make a cinematic Compeller visual
- List the Compeller visual styles and their pricing
- What is the status of Compel 12345?

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107701
- [Agent Skills Search Server](https://affpapa.org/en/nevibecode/mcp/agent-skills-search-server.md) — MCP server · ★ 26673
- [Skyvern](https://affpapa.org/en/nevibecode/mcp/skyvern.md) — MCP server · ★ 23283
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9369
- [PraisonAI](https://affpapa.org/en/nevibecode/mcp/praisonai.md) — MCP server · ★ 9298

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md