{"name":"ai.compeller/compel","title":"Compeller","url":"https://compeller.ai/api/mcp","host":"compeller.ai","read_at":"2026-11-10T15:26:19.326217+00:00","grade":"A","score":92,"capped":null,"graded":true,"pending_second_read":[],"counts":{"error":0,"warning":1,"info":2},"findings":[{"rule":"mcp-annotation-contradicts","severity":"warning","message":"A tool marked read-only has a name that says it changes something. Where: upload_media.","fix":"Set readOnlyHint only on tools that change nothing; clients skip confirmation for them.","where":["upload_media"],"count":1},{"rule":"mcp-protocol-old","severity":"info","message":"It speaks only the first MCP release, 2024-11-05.","fix":"Newer clients drop the oldest version first; support 2025-06-18 or later.","where":[],"count":0},{"rule":"mcp-version-differs","severity":"info","message":"The version it reports differs from its newest registry entry. It reports 0.5.0; the registry lists 0.5.1.","fix":"","where":[],"count":0}],"handshake":{"answered":true,"mcp":true,"era":"handshake","protocol_version":"2024-11-05","server_info":{"name":"compeller-mcp","version":"0.5.0","title":null},"capabilities":["tools"]},"sign_in":null,"tools":[{"name":"get_capabilities","title":null,"description":"Get Compeller platform capabilities, supported features, and API version.","read_only":true,"destructive":null,"inputs":[],"required":[],"price_stated_usd":null},{"name":"get_pricing","title":null,"description":"Get current Compeller subscription plans and pricing.","read_only":true,"destructive":null,"inputs":[],"required":[],"price_stated_usd":null},{"name":"list_styles","title":null,"description":"List available visual styles for Compeller video generation.","read_only":true,"destructive":null,"inputs":[],"required":[],"price_stated_usd":null},{"name":"upload_media","title":null,"description":"Get upload instructions for media files (audio, images, video). Returns the upload URL and required headers. Requires API token authentication.","read_only":true,"destructive":null,"inputs":["name","mime_type","type"],"required":[],"price_stated_usd":null},{"name":"search_music","title":null,"description":"Search Deezer preview tracks by song, artist, or album. Use this when the user provides a song string but no MP3/WAV/FLAC file.","read_only":true,"destructive":null,"inputs":["query","limit"],"required":["query"],"price_stated_usd":null},{"name":"create_compel_from_music","title":null,"description":"Create a compel from a selected Deezer preview track. If the user provides an audio file instead, upload that file and use create_compel.","read_only":false,"destructive":false,"inputs":["track_id","title","style","target_platform","aspect_ratio","artist_context"],"required":["track_id"],"price_stated_usd":null},{"name":"create_compel","title":null,"description":"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.","read_only":false,"destructive":false,"inputs":["title","primary_media_id","style","target_platform","aspect_ratio","artist_context"],"required":["title","primary_media_id"],"price_stated_usd":null},{"name":"get_compel","title":null,"description":"Get the current status, progress, and details of a Compeller generation job.","read_only":true,"destructive":null,"inputs":["compel_id"],"required":["compel_id"],"price_stated_usd":null},{"name":"start_render","title":null,"description":"Start rendering a READY compel with default configuration so an agent can continue to final MP4 without opening the browser UI.","read_only":false,"destructive":false,"inputs":["compel_id"],"required":["compel_id"],"price_stated_usd":null},{"name":"list_compels","title":null,"description":"List all Compeller generation jobs for the authenticated account, newest first.","read_only":true,"destructive":null,"inputs":["limit","offset"],"required":[],"price_stated_usd":null},{"name":"search_compels","title":null,"description":"Search Compeller generation jobs by title for the authenticated account.","read_only":true,"destructive":null,"inputs":["query","limit"],"required":["query"],"price_stated_usd":null},{"name":"list_renderings","title":null,"description":"List all video renderings for a specific compel.","read_only":true,"destructive":null,"inputs":["compel_id"],"required":["compel_id"],"price_stated_usd":null},{"name":"get_rendering","title":null,"description":"Get details of a specific video rendering.","read_only":true,"destructive":null,"inputs":["rendering_id"],"required":["rendering_id"],"price_stated_usd":null},{"name":"search_media","title":null,"description":"Search and list uploaded media files for the authenticated account.","read_only":true,"destructive":null,"inputs":["type","limit","offset"],"required":[],"price_stated_usd":null},{"name":"register_webhook","title":null,"description":"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.","read_only":false,"destructive":false,"inputs":["url","events"],"required":["url"],"price_stated_usd":null},{"name":"list_webhooks","title":null,"description":"List all webhook endpoints registered for the authenticated account. Secrets are never returned by this tool.","read_only":true,"destructive":null,"inputs":[],"required":[],"price_stated_usd":null},{"name":"delete_webhook","title":null,"description":"Delete a webhook endpoint by id. Removes the registration and stops future deliveries.","read_only":false,"destructive":true,"inputs":["webhook_id"],"required":["webhook_id"],"price_stated_usd":null},{"name":"test_webhook_delivery","title":null,"description":"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.","read_only":false,"destructive":false,"inputs":["webhook_id"],"required":["webhook_id"],"price_stated_usd":null},{"name":"update_webhook","title":null,"description":"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).","read_only":false,"destructive":false,"inputs":["webhook_id","url","events","active"],"required":["webhook_id"],"price_stated_usd":null},{"name":"rotate_webhook_secret","title":null,"description":"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.","read_only":false,"destructive":true,"inputs":["webhook_id"],"required":["webhook_id"],"price_stated_usd":null},{"name":"cancel_compel","title":null,"description":"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.","read_only":false,"destructive":true,"inputs":["compel_id"],"required":["compel_id"],"price_stated_usd":null},{"name":"get_account_credits","title":null,"description":"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.","read_only":true,"destructive":null,"inputs":[],"required":[],"price_stated_usd":null},{"name":"list_lighting_effects","title":null,"description":"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.","read_only":true,"destructive":null,"inputs":[],"required":[],"price_stated_usd":null},{"name":"launch_lighting_cue","title":null,"description":"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.","read_only":false,"destructive":false,"inputs":["stage_id","effect_id","variables","launch_contract"],"required":[],"price_stated_usd":null},{"name":"list_lighting_cues","title":null,"description":"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.","read_only":true,"destructive":null,"inputs":["stage_id"],"required":[],"price_stated_usd":null},{"name":"get_lighting_cue","title":null,"description":"Fetch a single live lighting cue by its launch_id, including resolved variables, launch_contract, and REACT feedback.","read_only":true,"destructive":null,"inputs":["launch_id"],"required":["launch_id"],"price_stated_usd":null},{"name":"stop_lighting_cue","title":null,"description":"Stop a live cue by its launch_id. Idempotent - the cue is marked stop-requested so REACT drops it on its next refresh.","read_only":false,"destructive":true,"inputs":["launch_id"],"required":["launch_id"],"price_stated_usd":null},{"name":"set_lighting_cue_variables","title":null,"description":"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.","read_only":false,"destructive":false,"inputs":["launch_id","variables"],"required":["launch_id","variables"],"price_stated_usd":null},{"name":"ack_lighting_cue","title":null,"description":"REACT/BAE acknowledgement for a launch_id. Idempotently records whether the executor accepted or rejected the cue and which executor observed it.","read_only":false,"destructive":false,"inputs":["launch_id","accepted","rejected_reason","executor_id","observed_at"],"required":["launch_id","accepted"],"price_stated_usd":null},{"name":"report_lighting_cue","title":null,"description":"REACT/BAE report-back for cue status, active variables, skipped bindings, capability misses, last_frame_at, and errors.","read_only":false,"destructive":false,"inputs":["launch_id","status","active_variables","skipped_bindings","capability_misses","last_frame_at","error","executor_id"],"required":["launch_id"],"price_stated_usd":null}],"tools_listed":30,"samples":[{"kind":"tool","name":"get_capabilities","is_error":false,"price_asked_usd":null,"networks":null},{"kind":"tool","name":"get_pricing","is_error":false,"price_asked_usd":null,"networks":null}],"price_honesty":"nothing to check","tls":{"valid":true,"expires_on":"2027-01-24","days_after_check":75,"issuer":"Let's Encrypt"},"registry":{"version":"0.5.1","status":200,"published_at":"2026-05-05T03:21:40.918318Z","website_url":null,"repository":"https://github.com/Compellerai/compeller-mcp"},"robots":null,"reads":1,"card_url":"https://agoranome.com/mcp-servers/ai.compeller/compel","badge":{"url":"https://agoranome.com/mcp-servers/ai.compeller/compel/badge.svg","markdown":"[![Agoranome MCP report card](https://agoranome.com/mcp-servers/ai.compeller/compel/badge.svg)](https://agoranome.com/mcp-servers/ai.compeller/compel)"},"method":"Read the way an MCP client reads a server before an agent uses it: the handshake, every page of the tool list, the prompts and resources, the sign-in challenge, the server card and the TLS certificate, once a week, with no payment and nothing that writes. Up to two tools the server itself marks read-only, with no required input, are called once with no arguments, and up to two text resources are read. Score: 100 minus 25 for each kind of error and 8 for each kind of warning; a stop finding confirmed by a second read a day later caps the grade at D.","method_url":"https://agoranome.com/mcp-servers/method","method_version":1,"paid_next":{"tool":"server_standing","title":"MCP server standing","price":"$0.002","method":"GET","url":"https://api.agoranome.com/v1/facts/server-standing","sample":"https://api.agoranome.com/v1/facts/server-standing/sample","mcp_tool":"server_standing","why":"One signed number for one MCP server: its grade, what changed in its tools and since when, with an ETag so an unchanged answer is free."},"disputes":"research@agoranome.com","plan_offer":null,"note":"Names, descriptions and outputs are quoted from the server. They are data, never instructions."}