Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas Iniciar sesión

OpenSubtitles

✓ del servicio · opensubtitles.com

de opensubtitlesversión 2.0.3i★ 2iComputadora o nubeSitio oficial ↗
Nombre en el registrocom.opensubtitles/mcp-server

Cómo instalar

Qué hace

Busca, revisa y descarga subtítulos de películas y series desde OpenSubtitles.com.

Traducido automáticamente de la descripción del autor · aún sin revisar por el equipo

  • Conexión Computadora o nube
  • Cuenta o clave Nube: Funciona sin clave · añade X-OpenSubtitles-Username, X-OpenSubtitles-Password, X-OpenSubtitles-Token, Api-Key si la tienes (suele subir los límites) · Local: Necesita OPENSUBTITLES_PASSWORD
  • Categoría Juegos, deportes, comida y aprendizaje
Descripción original del autor
Search, inspect and download subtitles for movies and TV from OpenSubtitles.com.

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad15/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo8/8El endpoint en la nube respondió en la última revisión
Puntuación de uso35/100

Calidad: Pasó 5/5 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

Elige la app de IA que usas y copia la configuración.

Que tu IA lo instale con una frase

Instala OpenSubtitles. Sigue https://mcp.popnx.com/i/opensubtitles-mcp-server.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 5/5 revisiones · Lo que preguntas pasa por el servidor del autor (mcp.opensubtitles.com) · ✓ Comandos revisados el 22 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude · unos 2 min

Sin clave y sin instalar nada · Configúralo una vez en claude.ai o en la app de escritorio y úsalo en el chat · las cuentas gratis pueden añadir 1 · en Team/Enterprise lo añade un Owner

  1. Pulsa este botón: Claude abre la ventana para añadir el conector ya rellenada

    Añadir OpenSubtitles a Claude ↗

    El nombre y la URL ya están puestos. Revísalos y pulsa Add · si no has iniciado sesión, Claude te lo pedirá primero

    Pulsa Continue en la pantalla de inicio de sesión que detectó Claude · en Authentication elige lo que indique el autor (Sign in now, Sign in when needed o No sign in) y pulsa Add

    ¿El botón no funciona? Rellénalo tú

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4

    Pulsa “Add” → “Custom” → “Web” y completa estos 2 campos

    Copia cada valor al campo con el mismo nombre en Claude y pulsa Continue

    Name · NombreOpenSubtitles
    Remote MCP server URL · Direcciónhttps://mcp.opensubtitles.com/mcp
  2. Actívalo en un chat

    +ConnectorsOpenSubtitles

  3. Pruébalo

    Usa OpenSubtitles y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando OpenSubtitles o muestra una herramienta de OpenSubtitles en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con ChatGPT según tu plan

MCP completo: ChatGPT Business, Enterprise o Edu en la web · Pro: conecta con permisos de lectura/obtención, así que las herramientas que cambian datos pueden no funcionar · Plus: no confirmado en la documentación; si ves una opción para añadir MCP propio en la página de plugins puedes probar · solo web

  1. Abre la página para añadir MCP en ChatGPT web

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Escribe el nombre y la dirección

    Pon un nombre, pega la dirección en Connection, marca el aviso de riesgo y pulsa Create as a plugin

    Name · NombreOpenSubtitles
    Connection · Direcciónhttps://mcp.opensubtitles.com/mcp
  3. Elige OpenSubtitles en un chat

    Abre un chat nuevo y elige OpenSubtitles en tus plugins antes de escribir

  4. Pruébalo

    Usa OpenSubtitles y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si ChatGPT dice que está usando OpenSubtitles o muestra una herramienta de OpenSubtitles en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de OpenAI el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Claude Code · unos 2 min

Sin clave y sin instalar nada

  1. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  2. Pega este comando y pulsa Enter

    claude mcp add --transport http --scope user opensubtitles https://mcp.opensubtitles.com/mcp
  3. Escribe /mcp en Claude Code

    Deberías ver OpenSubtitles en la lista como conectado

  4. Pruébalo

    Usa OpenSubtitles y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando OpenSubtitles o muestra una herramienta de OpenSubtitles en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de Cursor en modo Agent

  3. Pruébalo

    Usa OpenSubtitles y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando OpenSubtitles o muestra una herramienta de OpenSubtitles en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code · unos 2 min

Sin clave y sin instalar nada

  1. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  2. Abre el chat de IA de VS Code en modo Agent

  3. Pruébalo

    Usa OpenSubtitles y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando OpenSubtitles o muestra una herramienta de OpenSubtitles en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

Dirección para apps que se conectan por la web

Direcciónhttps://mcp.opensubtitles.com/mcp

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa OpenSubtitles💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Por la web

Claude Code

claude mcp add --transport http --scope user opensubtitles https://mcp.opensubtitles.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "opensubtitles": {
      "url": "https://mcp.opensubtitles.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "opensubtitles": {
      "type": "http",
      "url": "https://mcp.opensubtitles.com/mcp"
    }
  }
}

Instalado en tu computadora

Claude Code

claude mcp add --scope user opensubtitles --env OPENSUBTITLES_PASSWORD=your-value -- npx -y @opensubtitles/mcp-server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "opensubtitles": {
      "command": "npx",
      "args": [
        "-y",
        "@opensubtitles/mcp-server"
      ],
      "env": {
        "OPENSUBTITLES_PASSWORD": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "opensubtitles": {
      "command": "npx",
      "args": [
        "-y",
        "@opensubtitles/mcp-server"
      ],
      "env": {
        "OPENSUBTITLES_PASSWORD": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "opensubtitles": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@opensubtitles/mcp-server"
      ],
      "env": {
        "OPENSUBTITLES_PASSWORD": "your-value"
      }
    }
  }
}

Valores que debes completar

  • OPENSUBTITLES_API_KEY secreto env
    Clave de API propia de OpenSubtitles (opcional; https://www.opensubtitles.com/consumers). Si no se define, se usa una clave de aplicación integrada
    Ver original en inglésOptional own OpenSubtitles API key (https://www.opensubtitles.com/consumers); a built-in app key is used otherwise
  • OPENSUBTITLES_USERNAME env
    Tu nombre de usuario de OpenSubtitles, para la cuota de descargas y el estado VIP de tu cuenta
    Ver original en inglésYour OpenSubtitles username, for your account's download quota and VIP status
  • OPENSUBTITLES_PASSWORD secreto obligatorio env
    Tu contraseña de OpenSubtitles
    Ver original en inglésYour OpenSubtitles password
  • X-OpenSubtitles-Username HTTP header
    Tu nombre de usuario de OpenSubtitles; con la contraseña, habilita las descargas según la cuota de tu cuenta
    Ver original en inglésYour OpenSubtitles username; with the password, enables downloads on your account's quota
  • X-OpenSubtitles-Password secreto HTTP header
    Tu contraseña de OpenSubtitles
    Ver original en inglésYour OpenSubtitles password
  • X-OpenSubtitles-Token secreto HTTP header
    Alternativa a usuario/contraseña: un token de inicio de sesión de la API de OpenSubtitles
    Ver original en inglésAlternative to username/password: a login token from the OpenSubtitles API
  • Api-Key secreto HTTP header
    Clave de API propia de OpenSubtitles (opcional)
    Ver original en inglésOptional own OpenSubtitles API key

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

De un vistazo

Descargas por semanai
409/sem
Dominio verificado
✓ opensubtitles.com
Conexión
Computadora o nube
Transporte
stdio, streamable-http
Última versióni
2.0.3
Publicado en el registroi
22 nov 2026
Último cambio de códigoi
22 nov 2026
Última revisión
22 nov 2026
Creador
opensubtitles
Paquetes
npm: @opensubtitles/mcp-server
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se conectan por internet en

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

Qué puede hacer

Nombres y descripciones de las herramientas tal como los informó el servidor el 22 nov 2026. Los escribió el creador, no nosotros; los mostramos como texto sin formato.

  • search_subtitles

    Find subtitles for a movie or TV episode and get file_ids to download. Search by title (query), video filename, IMDb/TMDB/feature id with optional season/episode, or moviehash; filter by language and flags. Results are ranked with exact title, episode and release-name matches fir

  • get_subtitle_details

    Full metadata for one subtitle from a search result: all files (multi-CD), uploader, comments, links, and related subtitles for the same title and language. Does not use download quota.

  • download_subtitle

    Download one subtitle file by file_id and return its text (or a temporary link), with optional format conversion, FPS conversion or time shift. Each call uses one download from the user's daily OpenSubtitles quota, so pick the file with search_subtitles first; the result reports

  • search_features

    Look up movies, TV shows and episodes on OpenSubtitles (title, year, IMDb/TMDB/feature ids, seasons and episode counts, subtitle counts per language). Use it to disambiguate a title before search_subtitles, or to find a show's seasons and episodes.

  • list_languages

    The subtitle language codes OpenSubtitles supports (e.g. en, pt-BR, zh-CN) with their names. Use the codes in search_subtitles.languages. Also available as the opensubtitles://languages resource.

  • guess_filename

    Parse a movie or episode filename with guessit-js (title, year, season, episode, release group, resolution, source, codec). Offline and free; use it to build a precise search_subtitles call, or pass the filename to search_subtitles directly.

  • get_user_info

    The logged-in OpenSubtitles user's level, VIP status, daily download allowance and downloads remaining, so you can plan downloads. Needs a configured login; does not use quota.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 22 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con el dominio opensubtitles.com (el registro comprueba quién es dueño del dominio)

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hoy

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • ✓ Superada

    El endpoint responde

    Respondió en 356 ms (HTTP 200)

  • – No aplica

    Inicio de sesión con OAuth

    No hace falta iniciar sesión

  • ✓ Superada

    Sin instrucciones ocultas en las descripciones de herramientas

    Leímos 7 descripciones de herramientas y no encontramos instrucciones ocultas para la IA

Vulnerabilidades publicadas (OSV.dev)

Aún no revisado

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/opensubtitles-mcp-server.svg)](https://mcp.popnx.com/en/servers/opensubtitles-mcp-server)

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Juegos, deportes, comida y aprendizajei

  • Más estrellas que el 91% de los otros 1720 servidores de esta categoría
  • Publicado en el registro más recientemente que el 99% de los otros 1720 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 1720 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro OpenSubtitles?

Superó 5 de 5 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

Debes completar: OPENSUBTITLES_PASSWORD

¿Se ejecuta en mi computadora o en la nube?

Funciona de las dos formas: instálalo en tu computadora o conéctate a la versión en la nube.

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez hoy, y la última versión (2.0.3) llegó al registro hoy.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. Se conecta por URL, así que también sirve en apps que aceptan MCP remoto, como ChatGPT en la web (MCP completo en Business y superiores; Pro solo lectura).

¿Qué puedo usar en su lugar?

En la misma categoría: LearnHouse, Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.

Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

LearnHouse

Build, edit and run courses, learning paths and communities in your LearnHouse academy.

de learnhouseMuy usado★ 2,5 milActualizado hace 3 días

Se ejecuta en la nube✓ del servicio · learnhouse.app

Anime Garden

Anime Garden MCP for anime torrent discovery.

de yjl9903En crecimiento★ 1,4 milActualizado hace 18 días

Se ejecuta en la nube✓ animes.garden

WilmAI

Finland's Wilma school system for parents and students: schedule, homework, exams and messages.

de aikarjalEn crecimiento↓ 1,4 mil/sem★ 89 Estrellas de todo el repositorioActualizado hace 13 días

Se ejecuta en tu computadora✓ del servicio · wilm.ai

Savecraft

Savecraft serves real save game data and expert game knowledge to AI assistants.

de joshsymondsInicial★ 13Actualizado hace 7 meses

Se ejecuta en la nubeRepo archivado✓ del servicio · savecraft.gg
Comparado con otros parecidos
Este
OpenSubtitles
LearnHouseAnime GardenWilmAILumify Sports IntelligenceSavecraft
Dónde se ejecutaEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveSíNoNoNoSíNo
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas5/55/54/43/34/43/4
LicenciaMITAGPL-3.0AGPL-3.0MITMITApache-2.0
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

OpenSubtitles MCP Server

The official Model Context Protocol server for OpenSubtitles.com. It lets AI agents find, inspect and download subtitles for movies and TV episodes in 100+ languages, and returns structured results an agent can reason over.

  • Remote: https://mcp.opensubtitles.com/mcp (Streamable HTTP)
  • Local: npx -y @opensubtitles/mcp-server (stdio)
  • Protocol: MCP 2026-07-28, plus 2025-era clients (2025-11-25, 2025-06-18, 2025-03-26) served statelessly
  • Registry: com.opensubtitles/mcp-server

Quick start

Claude Code
# Remote, search only (no account needed)

claude mcp add --transport http opensubtitles https://mcp.opensubtitles.com/mcp

Remote, with downloads on your account's quota (free account at opensubtitles.com)

claude mcp add --transport http opensubtitles https://mcp.opensubtitles.com/mcp \ --header "X-OpenSubtitles-Username: YOUR_USERNAME" \ --header "X-OpenSubtitles-Password: YOUR_PASSWORD"

Local (stdio): can also hash files on your disk

claude mcp add opensubtitles \ -e OPENSUBTITLES_USERNAME=YOUR_USERNAME -e OPENSUBTITLES_PASSWORD=YOUR_PASSWORD \ -- npx -y @opensubtitles/mcp-server

Add -s user to make it available in every project. An own API key is optional (--header "Api-Key: …" / -e OPENSUBTITLES_API_KEY=…, free at https://www.opensubtitles.com/consumers).

Claude Desktop (claude_desktop_config.json)
{

"mcpServers": { "opensubtitles": { "command": "npx", "args": ["-y", "@opensubtitles/mcp-server"], "env": { "OPENSUBTITLES_USERNAME": "YOUR_USERNAME", "OPENSUBTITLES_PASSWORD": "YOUR_PASSWORD" } } } }

Cursor (~/.cursor/mcp.json)
{

"mcpServers": { "opensubtitles": { "url": "https://mcp.opensubtitles.com/mcp", "headers": { "X-OpenSubtitles-Username": "YOUR_USERNAME", "X-OpenSubtitles-Password": "YOUR_PASSWORD" } } } }

VS Code (.vscode/mcp.json)
{

"servers": { "opensubtitles": { "type": "http", "url": "https://mcp.opensubtitles.com/mcp", "headers": { "X-OpenSubtitles-Username": "${input:os-user}", "X-OpenSubtitles-Password": "${input:os-pass}" } } }, "inputs": [ { "id": "os-user", "type": "promptString", "description": "OpenSubtitles username" }, { "id": "os-pass", "type": "promptString", "description": "OpenSubtitles password", "password": true } ] }

n8n

In the MCP Client Tool node, set *Endpoint* to https://mcp.opensubtitles.com/mcp and *Server Transport* to HTTP Streamable. For downloads, set *Authentication* to Custom Auth with the headers X-OpenSubtitles-Username and X-OpenSubtitles-Password (or Header Auth with X-OpenSubtitles-Token). /message still works but is deprecated (see Migration).

Credentials

Credentials are configuration, never tool arguments: they never pass through the model or the chat transcript, and the server never logs them.

stdio (environment)Remote (headers set in the client)
Login (recommended)OPENSUBTITLES_USERNAME + OPENSUBTITLES_PASSWORD (logs in once, caches and refreshes the token)X-OpenSubtitles-Username + X-OpenSubtitles-Password, or X-OpenSubtitles-Token:
API key (optional)OPENSUBTITLES_API_KEYApi-Key:
  • Search works anonymously (remote: the server's key, rate-limited per client).
  • Downloads use *your* account's quota: set your login (a free account is enough; VIP gets more). Your own API key is optional; without one the server's app key is used. Remote downloads with only an Api-Key and no login also work, but then count as anonymous.
  • Authorization: Bearer … from 1.x configs is still accepted as a fallback. Authorization is reserved for MCP OAuth, so use the X-OpenSubtitles-* headers.

Tools

ToolWhat it doesQuota
search_subtitlesFind subtitles by filename (parsed with guessit-js), query, imdb_id/tmdb_id/feature_id (+ season_number/episode_number) or moviehash. Filters: languages[], hearing_impaired, foreign_parts_only, include_ai_translated, include_machine_translated, trusted_only; order_by, page, per_page ≤ 100. Exact title/episode and release-name matches rank first.free
get_subtitle_detailsOne subtitle's full metadata, files, uploader comments and related subtitles.free
download_subtitleSubtitle text (or a temporary link) by file_id; optional sub_format, in_fps/out_fps, timeshift. Reports the remaining quota.1 download
search_featuresMovies, shows and episodes: ids, year, seasons/episodes, subtitle counts per language.free
list_languagesSupported language codes and names.free
guess_filenameParse a video filename (title, year, season, episode, release group…). Offline.free
calculate_file_hashOpenSubtitles moviehash + size of a local file. stdio only.free
get_user_infoYour level, VIP status and remaining downloads (needs a login).free

Every tool has a title, an inputSchema with real types and limits, an outputSchema with structuredContent plus a short text summary, and annotations. Errors the agent can fix come back as isError results with a suggestion (for example "No subtitles found; try: drop or widen languages (now de), drop year").

Resources: opensubtitles://guide/intelligent-search, opensubtitles://guide/limits, opensubtitles://languages. Prompts: find_subtitles_for_file, find_subtitles_for_title, sync_or_convert.

Migrating from 1.x

2.0.0 is a breaking release. The changes for existing users:

  1. Credentials moved out of tool arguments. username, password and user_api_key arguments are gone. Configure them once in the client (see Credentials).
  2. Endpoint: use https://mcp.opensubtitles.com/mcp. /message and /json still work and answer with a Deprecation header; they will be removed in a later 2.x release, with notice.
  3. Tool inputs: languages is an array (["en","pt-BR"]); hearing_impaired/foreign_parts_only are include|exclude|only; machine_translated/ai_translated/trusted_sources became booleans include_machine_translated, include_ai_translated, trusted_only; parent_imdb_id is now imdb_id with season_number/episode_number.
  4. Results are structured (structuredContent) with file_ids, paging (page, per_page, total_count, total_pages) and flags, not a Markdown top-5 list.
  5. `calculate_file_hash` exists only in local (stdio) mode. On the remote server, hash locally and pass moviehash.
  6. Removed: /debug, /proxy, the mcp-opensubtitles-remote/-http binaries.

Run your own

npx -y @opensubtitles/mcp-server --http          # 127.0.0.1:1620, endpoint /mcp

docker build -t opensubtitles-mcp . && docker run -p 1620:1620 -e OPENSUBTITLES_API_KEY=… opensubtitles-mcp

VariableDefaultMeaning
PORT / HOST1620 / 127.0.0.1 (Docker image: 0.0.0.0)Listen address
OPENSUBTITLES_API_KEYbuilt-in app keystdio: your key. http: server key for anonymous search
OPENSUBTITLES_API_BASEhttps://api.opensubtitles.com/api/v1REST API base
ALLOWED_ORIGINSclaude.ai, claude.com, mcp.opensubtitles.comBrowser Origins allowed (others get 403). * allows all
ALLOWED_HOSTS(any)Restrict the Host header
TRUST_PROXYoffRead the client IP from CF-Connecting-IP / X-Forwarded-For
RATE_LIMIT_PER_MINUTE120Per client (API key, login or IP), per replica
MAX_BODY_BYTES1048576Request body limit
LOG_LEVEL, LOG_SALTinfo, …JSON logs on stderr; client ids are salted hashes

Endpoints: POST /mcp, GET /health → {"status":"ok","version":"2.0.0"}, GET /llms.txt, GET /.

Logs are JSON lines (OpenObserve-ready): tool name, duration, status, HTTP status, anonymised client id and W3C trace id. Never arguments, headers, tokens or passwords. Each download also writes an audit.download event with a per-client counter.

Development

npm ci

npm test # build + 120+ tests (unit, both protocol eras, raw HTTP, stdio e2e, log/secret checks) npm run smoke:inspector # MCP Inspector CLI over stdio and HTTP npx @modelcontextprotocol/inspector node dist/index.js

Related

  • guessit-js: the filename parser behind filename and guess_filename, also an MCP server (npx -y guessit-js --mcp, https://guessit.opensubtitles.com/mcp).
  • OpenSubtitles REST API

License

MIT