Per agenti IA

Converti video con MCP

Muxara espone un server MCP remoto così Claude, Cursor e altri agenti possono creare lavori di conversione, caricare media e scaricare i risultati - con lo stesso limite di 500 MB e limiti di fair use di muxara.com.

Strumenti

Otto strumenti MCP replicano il flusso di conversione del sito. Gli agenti li chiamano via Streamable HTTP sull'endpoint sotto.

list_conversions

Elenca tutti gli 82 slug di conversione con estensioni di input accettate e formato di output.

get_conversion_defaults

Ottiene parametri predefiniti e validi di codec, qualità e trim per uno slug.

create_conversion_job

Crea un lavoro e riceve un URL di upload firmato (max 500 MB in input).

confirm_upload

Conferma che il file è stato caricato sull'URL firmato.

update_conversion_job

Modifica formato di output o impostazioni di conversione prima dell'elaborazione.

start_conversion

Accoda la conversione FFmpeg sul worker.

get_conversion_status

Interroga stato e progresso del lavoro quando pronto.

get_media_info

Analizza il file caricato per durata, risoluzione, codec e bitrate.

Casi d'uso

Assistenti chat IA

Un utente chiede al proprio assistente di convertire un MKV in MP4. L'agente elenca i formati, crea un lavoro, guida l'upload e restituisce un link di download quando pronto.

Pipeline di automazione

Script o job CI creano conversioni, caricano via URL firmati e interrogano lo stato senza browser - utile per flussi di preparazione media.

Scoperta formati

Gli agenti chiamano list_conversions e get_conversion_defaults prima di scegliere lo slug giusto per estensione del file e dispositivo di destinazione.

Integrazioni editor e CMS

Crea strumenti personalizzati che delegano la transcodifica a Muxara mantenendo gli stessi limiti del sito pubblico.

Flusso di lavoro

I byte del file non transitano nelle chiamate agli strumenti MCP. L'upload usa un URL firmato, come sul sito.

  1. create_conversion_job - restituisce jobId e uploadUrl
  2. PUT del file su uploadUrl (Content-Type: application/octet-stream)
  3. confirm_upload
  4. start_conversion (opzionalmente update_conversion_job prima)
  5. get_conversion_status finché lo status è ready
  6. Scarica dall'URL nella risposta di stato

Connetti

Usa il trasporto Streamable HTTP. L'endpoint canonico è https://api.muxara.com/mcp (alias: /sse).

Cursor

Aggiungi alla config MCP (.cursor/mcp.json o impostazioni Cursor):

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

MCP Inspector

Avvia l'inspector, scegli Streamable HTTP e inserisci l'URL completo dell'endpoint:

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

Autenticazione

Il server MCP è pubblico - nessuna chiave API, OAuth o account Muxara richiesto.

  • Nessuna chiave API o registrazione
  • Streamable HTTP su api.muxara.com/mcp
  • Si applicano limiti di fair use
  • Conversione e download gratuiti

Stessi limiti del sito web

Gli strumenti MCP usano la stessa job API di muxara.com. Questi limiti valgono per ogni client.

Upload max500 MB per file
Creazione lavori20 lavori all'ora (limite fair use)
Richieste API120 richieste al minuto (limite fair use)
Conservazione file24 ore
Coppie di conversione82 slug
CostoGratis: converti e scarica senza costi (fino a 500 MB per file, si applicano limiti di uso equo).

Documentazione

File di discovery leggibili da macchina e riferimento completo per provider LLM.

Domande frequenti

No. Il server MCP è pubblico con limiti fair use, come il sito. Non serve OAuth né account.

No. create_conversion_job restituisce una uploadUrl firmata. PUT del file direttamente su quell'URL (fino a 500 MB), poi chiama confirm_upload. Come l'uploader del browser.

No. Conversione e download sono gratuiti, come su muxara.com.

Sì. Avvia il worker Muxara sulla porta 3001 e connettiti a http://localhost:3001/mcp con MCP Inspector o il tuo client.