Für KI-Agenten

Video mit MCP konvertieren

Muxara stellt einen Remote-MCP-Server bereit, damit Claude, Cursor und andere Agenten Konvertierungsaufträge erstellen, Medien hochladen und Ergebnisse herunterladen können – mit demselben 500-MB-Limit und Fair-Use-Grenzen wie muxara.com.

Tools

Acht MCP-Tools spiegeln den Konvertierungsablauf der Website. Agenten rufen diese über Streamable HTTP am unten genannten Endpunkt auf.

list_conversions

Alle 82 Konvertierungs-Slugs mit akzeptierten Eingabeerweiterungen und Ausgabeformat auflisten.

get_conversion_defaults

Standard- und gültige Codec-, Qualitäts- und Trim-Parameter für einen Slug abrufen.

create_conversion_job

Auftrag erstellen und signierte Upload-URL erhalten (max. 500 MB Eingabe).

confirm_upload

Bestätigen, dass die Datei zur signierten URL hochgeladen wurde.

update_conversion_job

Ausgabeformat oder Konvertierungseinstellungen vor der Verarbeitung ändern.

start_conversion

FFmpeg-Konvertierung auf dem Worker einreihen.

get_conversion_status

Auftragsstatus und Fortschritt abfragen, wenn bereit.

get_media_info

Hochgeladene Datei auf Dauer, Auflösung, Codecs und Bitrate prüfen.

Anwendungsfälle

KI-Chat-Assistenten

Ein Nutzer bittet seinen Assistenten, MKV in MP4 zu konvertieren. Der Agent listet Formate auf, erstellt einen Auftrag, leitet den Upload an und liefert einen Download-Link, wenn fertig.

Automatisierungs-Pipelines

Skripte oder CI-Jobs erstellen Konvertierungsaufträge, laden über signierte URLs hoch und fragen den Status ohne Browser ab – nützlich für Medien-Prep-Workflows.

Format-Erkennung

Agenten rufen list_conversions und get_conversion_defaults auf, bevor sie den passenden Slug für Dateierweiterung und Zielgerät wählen.

Editor- und CMS-Integrationen

Eigene Tools bauen, die Transcodierung an Muxara übergeben und dabei dieselben Limits wie die öffentliche Website einhalten.

Ablauf

Dateibytes werden nicht über MCP-Tool-Aufrufe gesendet. Der Upload nutzt eine signierte URL, wie auf der Website.

  1. create_conversion_job - liefert jobId und uploadUrl
  2. Datei per PUT an uploadUrl senden (Content-Type: application/octet-stream)
  3. confirm_upload
  4. start_conversion (optional vorher update_conversion_job)
  5. get_conversion_status bis status ready ist
  6. Download von der URL in der Status-Antwort

Verbinden

Streamable HTTP als Transport nutzen. Der kanonische Endpunkt ist https://api.muxara.com/mcp (Alias: /sse).

Cursor

In Ihrer MCP-Konfiguration hinzufügen (.cursor/mcp.json oder Cursor-Einstellungen):

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

MCP Inspector

Inspector starten, Streamable HTTP wählen und die vollständige Endpunkt-URL eingeben:

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

Authentifizierung

Der MCP-Server ist öffentlich – keine API-Schlüssel, OAuth oder Muxara-Konto erforderlich.

  • Kein API-Schlüssel oder Registrierung
  • Streamable HTTP unter api.muxara.com/mcp
  • Fair-Use-Ratenlimits gelten
  • Kostenlose Konvertierung und Download

Gleiche Limits wie die Website

MCP-Tools nutzen dieselbe Job-API wie muxara.com. Diese Limits gelten für jeden Client.

Max. Upload500 MB pro Datei
Auftragserstellung20 Aufträge pro Stunde (Fair-Use-Limit)
API-Anfragen120 Anfragen pro Minute (Fair-Use-Limit)
Dateiaufbewahrung24 Stunden
Konvertierungspaare82 Slugs
KostenKostenlos – konvertieren und herunterladen ohne Gebühr (bis zu 500 MB pro Datei, Fair-Use-Ratenlimits gelten).

Dokumentation

Maschinenlesbare Discovery-Dateien und vollständige Agenten-Referenz für LLM-Anbieter.

Häufige Fragen

Nein. Der MCP-Server ist öffentlich mit Fair-Use-Limits, wie die Website. Kein OAuth oder Konto erforderlich.

Nein. create_conversion_job liefert eine signierte uploadUrl. Datei per PUT direkt an diese URL senden (bis 500 MB), dann confirm_upload aufrufen. Entspricht dem Browser-Uploader.

Nein. Konvertierung und Download sind kostenlos, wie auf muxara.com.

Ja. Muxara-Worker auf Port 3001 starten und mit MCP Inspector oder Ihrem Client zu http://localhost:3001/mcp verbinden.