Connect

8 clients · secrets stay placeholders

JSON (mcpServers)Claude CodeCodexOpenCodeCursorVS CodeGemini CLIGoose

{
  "mcpServers": {
    "compel": {
      "type": "http",
      "url": "https://compeller.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${COMPEL_TOKEN}",
        "X-API-Token": "${X_API_TOKEN}"
      }
    }
  }
}

claude mcp add --transport http compel https://compeller.ai/api/mcp --header "Authorization: Bearer ${COMPEL_TOKEN}" --header "X-API-Token: ${X_API_TOKEN}"

[mcp_servers.compel]
url = "https://compeller.ai/api/mcp"
bearer_token_env_var = "COMPEL_TOKEN"
env_http_headers = { "X-API-Token" = "X_API_TOKEN" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "compel": {
      "type": "remote",
      "url": "https://compeller.ai/api/mcp",
      "enabled": true,
      "headers": {
        "Authorization": "Bearer {env:COMPEL_TOKEN}",
        "X-API-Token": "{env:X_API_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "compel": {
      "type": "http",
      "url": "https://compeller.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${COMPEL_TOKEN}",
        "X-API-Token": "${X_API_TOKEN}"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=compel&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vY29tcGVsbGVyLmFpL2FwaS9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgJHtDT01QRUxfVE9LRU59IiwiWC1BUEktVG9rZW4iOiIke1hfQVBJX1RPS0VOfSJ9fQ%3D%3D"
}

{
  "servers": {
    "compel": {
      "type": "http",
      "url": "https://compeller.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${COMPEL_TOKEN}",
        "X-API-Token": "${X_API_TOKEN}"
      }
    }
  }
}

{
  "mcpServers": {
    "compel": {
      "httpUrl": "https://compeller.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${COMPEL_TOKEN}",
        "X-API-Token": "${X_API_TOKEN}"
      }
    }
  }
}

extensions:
  "compel":
    enabled: true
    name: "compel"
    type: streamable_http
    uri: "https://compeller.ai/api/mcp"
    headers:
      "Authorization": "Bearer ${COMPEL_TOKEN}"
      "X-API-Token": "${X_API_TOKEN}"
    timeout: 300

Placeholders to fill from your own secret store: ${COMPEL_TOKEN}, ${X_API_TOKEN}. The registry never accepts secret values.

Quality 85 / 100good

protocol75 · weight 25

warn
protocol.modernnewest supported version is 2024-11-05; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
n/a
protocol.statelessonly applies to 2026-07-28 servers
pass
protocol.transportstreamable HTTP
n/a
protocol.list_ttlonly applies to 2026-07-28 servers

authorizationn/a · weight 15

n/a
auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
n/a
auth.secret_in_urlno templated URL

tool hygiene86 · weight 30

pass
tools.descriptionsevery tool has a description
pass
tools.description_lengthdescriptions are concise
pass
tools.schemasevery tool has an object input schema
pass
tools.annotations30 of 30 tools declare readOnlyHint or destructiveHint
fail
tools.directory_hintsno tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: get_rendering (destructiveHint, idempotentHint, openWorldHint); search_media (destructiveHint, idempotentHint, openWorldHint); get_account_credits (destructiveHint, idempotentHint, openWorldHint); …
pass
tools.token_costabout 4,108 tokens to load every tool
pass
tools.api_dumptools are not a one-to-one API dump

stability100 · weight 15

pass
stability.changesno tool changes in 30 days
pass
stability.rug_pullno tool changed its meaning under the same name

dependenciesn/a · weight 15

n/a
deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

30 tools, about 4,108 tokens to load them all · tool set 3ac5732164d1 · checked 2026-10-20 09:31 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 86 / 100

provenance75

liveness100

freshness65

hygiene100

+repository +dns-namespace +reachable +uptime-100% ~updated-168d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remote	auth	reachable	uptime 30d	p50	protocol	last ok
`https://compeller.ai/api/mcp` streamable-http	none	yes	100%	411 ms	2024-11-05	2026-10-20

Tools (30)

`ack_lighting_cue`	REACT/BAE acknowledgement for a launch_id. Idempotently records whether the executor accepted or rejected the cue and which executor observed it.
`cancel_compel`destructive	Cancel an in-progress compel. Dequeues it if still queued, otherwise cancels any active external (AI provider) tasks and transitions it to CANCELLED. Idempotent - cancelling an already-CANCELLED compel succeeds. Use to stop a mis-prompted or runaway job before it consumes more render minutes.
`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.
`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.
`delete_webhook`destructive	Delete a webhook endpoint by id. Removes the registration and stops future deliveries.
`get_account_credits`read-only	Get the authenticated account's render-minute balance and plan: minutes remaining (free + paid), monthly allowance, plan code, and whether the quota is exceeded. Call before starting an expensive render so an agent can make cost-aware decisions.
`get_capabilities`read-only	Get Compeller platform capabilities, supported features, and API version.
`get_compel`read-only	Get the current status, progress, and details of a Compeller generation job.
`get_lighting_cue`read-only	Fetch a single live lighting cue by its launch_id, including resolved variables, launch_contract, and REACT feedback.
`get_pricing`read-only	Get current Compeller subscription plans and pricing.
`get_rendering`read-only	Get details of a specific video rendering.
`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 speed 0.5"). Pass effect_id (from list_lighting_effects) and optional variables to override effect defaults. Validation is loud: an unknown effect, a launch_contract whose bindings a stage cannot render, or a missing required field is rejected. Returns the active cue including its launch_id, resolved variables, and launch_contract for REACT. REACT executes the cue per-frame; the live strobe slider stays authoritative and is never raised by a launch.
`list_compels`read-only	List all Compeller generation jobs for the authenticated account, newest first.
`list_lighting_cues`read-only	List the live (non-stopped) lighting cues REACT is executing, including each cue's launch_id, resolved variables, launch_contract, and feedback. Optionally scope to one stage.
`list_lighting_effects`read-only	List the COM-497 starter lighting effects available to launch as cues (e.g. "gobo-cycle", "x-move", "dimmer-pulse"). Each effect carries an id, the capabilities it needs, and a launch_contract template. Use the returned id as effect_id for launch_lighting_cue.
`list_renderings`read-only	List all video renderings for a specific compel.
`list_styles`read-only	List available visual styles for Compeller video generation.
`list_webhooks`read-only	List all webhook endpoints registered for the authenticated account. Secrets are never returned by this tool.
`register_webhook`	Register an HTTPS endpoint to receive signed push notifications for compel lifecycle events (compel.ready when renderable, 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. Delivery is at-least-once: a failed delivery is retried with backoff (up to 6 attempts) and every retry carries the same X-Compeller-Event-Id, so dedupe on it.
`report_lighting_cue`	REACT/BAE report-back for cue status, active variables, skipped bindings, capability misses, last_frame_at, and errors.
`rotate_webhook_secret`destructive	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.
`search_compels`read-only	Search Compeller generation jobs by title for the authenticated account.
`search_media`read-only	Search and list uploaded media files for the authenticated account.
`search_music`read-only	Search Deezer preview tracks by song, artist, or album. Use this when the user provides a song string but no MP3/WAV/FLAC file.
`set_lighting_cue_variables`	Update variables on a live cue (e.g. change cycle speed or intensity mid-show). Only the variables you pass change; the rest keep their current values. Stopped cues are rejected.
`start_render`	Start rendering a READY compel with default configuration so an agent can continue to final MP4 without opening the browser UI.
`stop_lighting_cue`destructive	Stop a live cue by its launch_id. Idempotent - the cue is marked stop-requested so REACT drops it on its next refresh.
`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.
`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).
`upload_media`read-only	Get upload instructions for media files (audio, images, video). Returns the upload URL and required headers. Requires API token authentication.

Schemas: list_tools.

Similar MCP servers

Official server.json

{
  "name": "ai.compeller/compel",
  "title": "Compeller",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://compeller.ai/api/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "description": "Bearer token from Compeller Account → API Access, POST /api/login, or POST /api/v1/auth/token. Discovery tools work without this header; generation/account tools require it."
        },
        {
          "name": "X-API-Token",
          "isSecret": true,
          "description": "Alternative Compeller API token header. Use this instead of Authorization if your MCP client stores token values without the Bearer prefix."
        }
      ]
    }
  ],
  "version": "0.5.1",
  "repository": {
    "url": "https://github.com/Compellerai/compeller-mcp",
    "source": "github"
  },
  "description": "Create and track AI music videos and audio-reactive visuals from songs."
}