UnMarkAI

Servidor MCP impulsado por IA para eliminar subtítulos, leyendas y texto en pantalla codificados de videos a través de la API de UnMarkAI.

GitHub

Prueba este MCPPatrocinado

Documentación

unmarkai-skills

Habilidades de agente para UnmarkAI — permite que Claude, Codex, Cursor, opencode y cualquier agente compatible con MCP eliminen texto incrustado (subtítulos, leyendas, títulos en pantalla) de videos que te pertenecen con un solo UNMARKAI_API_KEY y sin otra configuración.

Página del producto: API de eliminación de texto en video y servidor MCP.

Dos formas de conectarse, el mismo motor debajo:

Servidor MCP remoto (recomendado): https://api.unmarkai.net/mcp
REST simple (sin necesidad de soporte MCP): guía completa de curl en skills/unmarkai-remove-text/references/curl-fallback.md

Lo que obtienes


Herramientas	`create_upload`, `create_url_upload`, `get_upload`, `remove_text`, `get_job`, `list_jobs`, `cancel_job`, `get_balance`, `estimate_cost`
Precios	Por segundo, redondeado hacia arriba, mínimo 1s — `all_area` $0.010/s, `sel_area` $0.005/s (región parcial, ~mitad de precio)
Límites	Máximo 2 GiB / 60 min por video; mp4 / mov / avi / mkv / webm / mpeg
Resultado	Enlace de descarga firmado, válido por 1 hora (archivo conservado 7 días)
Límites de tasa	50 escrituras / 120 lecturas por minuto

Configuración: obtén una clave

Inicia sesión en unmarkai.net y abre la Consola de API (Panel → API).
Crea una clave de API con los alcances jobs:read, jobs:write, balance:read.
Recarga la billetera de API (pago por uso).
Expórtala:

export UNMARKAI_API_KEY="uma_live_xxxxxxxxxxxx"

Conecta tu agente (MCP remoto)

Claude Code

claude mcp add --transport http unmarkai https://api.unmarkai.net/mcp \
  --header "Authorization: Bearer $UNMARKAI_API_KEY"

Luego instala la habilidad para que Claude Code siga el flujo completo (selección de modo, márgenes de rectángulo, triaje de errores):

mkdir -p ~/.claude/skills && \
  cp -r skills/unmarkai-remove-text ~/.claude/skills/

Claude Desktop

Claude Desktop no se comunica de forma nativa con servidores MCP HTTP remotos — conéctalo con mcp-remote en claude_desktop_config.json:

{
  "mcpServers": {
    "unmarkai": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.unmarkai.net/mcp",
        "--header",
        "Authorization: Bearer uma_live_xxxxxxxxxxxx"
      ]
    }
  }
}

Cursor

~/.cursor/mcp.json:

{
  "mcpServers": {
    "unmarkai": {
      "type": "http",
      "url": "https://api.unmarkai.net/mcp",
      "headers": { "Authorization": "Bearer uma_live_xxxxxxxxxxxx" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json — misma forma que Cursor pero con el tipo streamable-HTTP (consulta la documentación de Windsurf para tu versión):

{
  "mcpServers": {
    "unmarkai": {
      "type": "streamableHttp",
      "url": "https://api.unmarkai.net/mcp",
      "headers": { "Authorization": "Bearer uma_live_xxxxxxxxxxxx" }
    }
  }
}

Codex CLI

Streamable HTTP sigue siendo experimental en Codex — habilita el cliente RMCP y declara el servidor en ~/.codex/config.toml:

experimental_use_rmcp_client = true

[mcp_servers.unmarkai]
url = "https://api.unmarkai.net/mcp"
bearer_token = "uma_live_xxxxxxxxxxxx"

Codex no tiene un sistema nativo de habilidades; coloca las instrucciones del flujo en tu AGENTS.md en su lugar — consulta codex/AGENTS-snippet.md. Si el cliente HTTP experimental se comporta mal en tu versión de Codex, recurre al flujo curl.

opencode

~/.config/opencode/opencode.json (o opencode.json en un proyecto):

{
  "mcp": {
    "unmarkai": {
      "type": "remote",
      "url": "https://api.unmarkai.net/mcp",
      "headers": { "Authorization": "Bearer uma_live_xxxxxxxxxxxx" }
    }
  }
}

Gemini CLI

~/.gemini/settings.json:

{
  "mcpServers": {
    "unmarkai": {
      "httpUrl": "https://api.unmarkai.net/mcp",
      "headers": { "Authorization": "Bearer uma_live_xxxxxxxxxxxx" }
    }
  }
}

Pruébalo

Una vez conectado, simplemente pregunta:

Elimina los subtítulos incrustados de draft.mp4 (es mi propio video). Estima el costo primero, usa el modo más económico que cubra el área de subtítulos y descarga la versión limpia junto al original.

El agente analizará el video, cotizará la estimación, importará una URL HTTPS directa o subirá un archivo local con un ticket de un solo uso, creará el trabajo, esperará la finalización y descargará el resultado.

Verifica la conexión

curl -sS -X POST https://api.unmarkai.net/mcp \
  -H "Authorization: Bearer $UNMARKAI_API_KEY" \
  -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Un resultado JSON-RPC que liste las nueve herramientas significa que todo funciona. 401 unauthorized means the key is wrong; 404 significa que llegaste a la URL incorrecta.

Solución de problemas

Síntoma	Solución
`unauthorized`	La clave debe comenzar con `uma_live_` y estar activa; revisa la Consola de API
`insufficient_scope`	Recrea la clave con `jobs:read jobs:write balance:read`
`rate_limit_exceeded`	Ve más lento — los agentes deben consultar como máximo una vez cada 2s
`insufficient_balance`	Recarga la billetera de API en el panel
El cliente no puede conectarse al MCP remoto	Revisa la sintaxis del cliente arriba para la forma exacta de configuración; en el peor caso usa el respaldo curl
El PUT de carga devuelve 412	Los tickets de carga son de un solo uso — solicita uno nuevo
La importación de URL falla	Usa una URL HTTPS pública que devuelva directamente un video compatible con un Content-Length estable; los enlaces de páginas no se aceptan

Notas de seguridad

La clave otorga gasto desde tu billetera de API — trátala como una tarjeta de crédito.
Prefiere la expansión de variables de entorno ($UNMARKAI_API_KEY) en lugar de pegar literales en archivos de configuración cuando el cliente lo admita.
Rota la clave en la Consola de API si se filtra; revócala inmediatamente si se comparte en un repositorio (git rm --cached + reescribe el historial).

Uso responsable

Esta herramienta es para videos que te pertenecen o que estás autorizado a modificar. La habilidad incluye una salvaguarda que rechaza trabajos dirigidos a avisos de atribución, etiquetas de procedencia (incluidas divulgaciones de contenido de IA) o texto legal. Eliminar tales marcadores de contenido que no controlas puede ser ilegal — no lo hagas.