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.

Strumenti

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

list_conversions

Elenca tutte le opzioni 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 è https://api.muxara.com/mcp.

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

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.