MCP Server & REST API for Autonomous Agents

Give your coding agent 73+ video, image & audio models

Connect Claude Code, Codex, Cursor, or custom workflows to ReelMux via the Model Context Protocol (/api/mcp) or REST API. Agents can browse models and estimate exact credit costs with zero authentication, then generate assets using a scoped API key.

Read /agents.md Spec Inspect Live /api/mcp Schema

Recommended Agent Workflow

Discover models (No key needed)

Call list_models or get_model to inspect capabilities, resolutions, and audio support.

Estimate exact cost upfront

Call estimate_generation to quote the exact credit price before running any job.

Create generation with scoped key

Call create_generation using a Bearer rmx_live_... token with generation:create scope.

Poll & auto-refund protection

Poll get_generation until succeeded. Failed jobs automatically refund 100% of held credits.

1. Connect MCP Server

Add https://reelmux.com/api/mcp to your agent in one command.

Add ReelMux MCP server in Claude Code CLI

claude mcp add reelmux https://reelmux.com/api/mcp

Scoped API Keys

2. Create an Agent API Key

Read-only discovery (list_models, get_model, estimate_generation) works without an API key. Create a scoped key to allow agents to run jobs from your credit balance.

Your Active Agent Keys

Header: Authorization: Bearer rmx_live_...

default-mcp-agentActive

rmx_live_9f8a••••••••••••4c21

generation:creategeneration:read

All agent keys share your unified workspace credit balance and ledger.View Ledger →

3. MCP Tools & Endpoints

All 6 tools are exposed over JSON-RPC 2.0 at POST /api/mcp.

list_models

scope: publicNo API Key Required

Query all 73+ video, image, and audio models by media_type ('video' | 'image' | 'audio'), model family ('kling', 'seedance', 'veo', 'flux'), or free-text search.

Params: media_type?: 'video' | 'image' | 'audio', family?: string, search?: string

Returns: Array of models with maker, resolutions, aspect ratios, duration limits, audio support, and starting credits.

get_model

scope: publicNo API Key Required

Inspect full specification, supported parameter ranges, and exact pricing formula for a single model.

Params: model_id: string (required, e.g. 'kling-4.0', 'seedance-2.5')

Returns: Complete model contract and capability metadata.

estimate_generation

scope: publicNo API Key Required

Compute the exact credit cost for a job before spending any credits.

Params: model_id: string, duration_seconds?: number, resolution?: string, aspect_ratio?: string, audio?: boolean

Returns: { model_id, estimated_credits, parameters, policy }

create_generation

scope: generation:createBearer rmx_live_...

Submit a text-to-video, image-to-video, frames-to-video, reference-to-video, image, or audio generation job.

Params: model_id: string, prompt: string, mode?: string, image_url?: string, duration?: number, resolution?: string, aspect_ratio?: string, native_audio?: boolean

Returns: { generation_id, status: 'queued' | 'processing', estimated_credits }

get_generation

scope: generation:readBearer rmx_live_...

Poll job progress and retrieve finished video, image, or audio asset URLs.

Params: generation_id: string (required)

Returns: { id, status, output: { media_url, duration_sec }, error }

list_generations

scope: generation:readBearer rmx_live_...

Fetch paginated history of previous generations for the workspace.

Params: limit?: number, cursor?: string

Returns: { generations: [...], next_cursor }

Live MCP PlaygroundPOST /api/mcp

Select MCP Tool

model_id

resolution

duration_seconds

JSON-RPC Response

// Click "Execute" above to test the live MCP server endpoint