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 - with the same 500 MB limit and fair-use limits as muxara.com.

Tools

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

list_conversions

List all 82 conversion slugs 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.

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

Connect

Use Streamable HTTP transport. The canonical endpoint is https://api.muxara.com/mcp (alias: /sse).

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

Same limits as the website

MCP tools delegate to the same job API as muxara.com. These limits apply to every client.

Max upload	500 MB per file
Job creation	20 jobs per hour (fair-use limit)
API requests	120 requests per minute (fair-use limit)
File retention	24 hours
Conversion pairs	82 slugs
Cost	Free - convert and download at no cost (up to 500 MB per file, fair-use rate limits apply).

Documentation

Machine-readable discovery files and full agent reference for LLM providers.

llms.txt
Curated site index for LLM agents
llms-full.txt
Full reference with tools, API, and conversion guides
.well-known/mcp.json
MCP server discovery metadata
.well-known/mcp/server-card.json
Tool list, limits, and endpoint details

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.

Yes. Run the Muxara worker on port 3001 and connect to http://localhost:3001/mcp with MCP Inspector or your client.