# Compeller

Compeller turns music into visuals for live performance and promo content
via a patent-pending real-time audio-driven show pipeline. Musicians,
content creators, and venues submit audio, pick a style, and receive
performance-ready video.

## For agents and integrators

- Agent discovery page: https://compeller.ai/for-agents
- Machine manifest:     https://compeller.ai/agents.json
- REST API base:        https://compeller.ai/api/v1
- OpenAPI 3.1 spec:     https://compeller.ai/api/v1/openapi.yaml
- MCP endpoint:         https://compeller.ai/api/mcp (JSON-RPC 2.0 over HTTP POST)
- MCP docs:             https://compeller.ai/api/mcp (see /for-agents for a
                        link to the MCP documentation page)

## Capabilities

- Create a compel (music-video generation job) from uploaded audio.
- List, search, and cancel compels.
- Retrieve renderings with HTTP Range support.
- Register webhook endpoints for signed push notifications.
- Test, update, and rotate webhook endpoints synchronously.

## Authentication

Bearer API token on every v1 and MCP request:

    Authorization: Bearer <your-api-token>

Or equivalently:

    X-API-Token: <your-api-token>

Tokens are issued per Compeller user account. A missing or invalid token
returns 401 on REST and a tool-level error on MCP.