For AI agents

Convert video with MCP

Muxara exposes a remote MCP server so Claude, Cursor, and other agents can create conversion jobs, upload media, and download results.

Tools

Eight MCP tools mirror the website conversion flow. Agents call these over Streamable HTTP at the endpoint below.

list_conversions

List all conversion options with accepted input extensions and output format.

get_conversion_defaults

Get default and valid codec, quality, and trim parameters for a slug.

create_conversion_job

Create a job and receive a signed upload URL (max 500 MB input).

confirm_upload

Confirm the file was uploaded to the signed URL.

update_conversion_job

Change output format or conversion settings before processing.

start_conversion

Queue FFmpeg conversion on the worker.

get_conversion_status

Poll job status and progress when ready.

get_media_info

Probe uploaded file for duration, resolution, codecs, and bitrate.

Use cases

AI chat assistants

A user asks their assistant to convert an MKV to MP4. The agent lists formats, creates a job, guides the upload, and returns a download link when ready.

Automation pipelines

Scripts or CI jobs create conversion jobs, upload via signed URLs, and poll status without a browser - useful for media prep workflows.

Format discovery

Agents call list_conversions and get_conversion_defaults before choosing the right slug for a user's file extension and target device.

Editor and CMS integrations

Build custom tools that hand off transcoding to Muxara while keeping the same limits as the public website.

Workflow

File bytes are not sent through MCP tool calls. Upload uses a signed URL, same as the website.

  1. create_conversion_job - returns jobId and uploadUrl
  2. PUT the file to uploadUrl (Content-Type: application/octet-stream)
  3. confirm_upload
  4. start_conversion (optionally update_conversion_job first)
  5. get_conversion_status until status is ready
  6. Download from the URL in the status response

Connect

Use Streamable HTTP transport. The endpoint is https://api.muxara.com/mcp.

Cursor

Add to your MCP config (.cursor/mcp.json or Cursor settings):

{
  "mcpServers": {
    "muxara": {
      "url": "https://api.muxara.com/mcp"
    }
  }
}

MCP Inspector

Run the inspector, choose Streamable HTTP, and enter the full endpoint URL:

npx @modelcontextprotocol/inspector
# Streamable HTTP → https://api.muxara.com/mcp

Authentication

The MCP server is public - no API keys, OAuth, or Muxara account required.

  • No API key or sign-up
  • Streamable HTTP at api.muxara.com/mcp
  • Fair-use rate limits apply
  • Free conversion and download

FAQ

No. The MCP server is public with fair-use limits, same as the website. No OAuth or account is required.

No. create_conversion_job returns a signed uploadUrl. PUT the file directly to that URL (up to 500 MB), then call confirm_upload. This matches how the browser uploader works.

No. Conversion and download are free, same as muxara.com.