Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt Anmelden

OpenSubtitles

✓ vom Dienst · opensubtitles.com

von opensubtitlesVersion 2.0.3i★ 2iComputer oder CloudOffizielle Website ↗
Name in der Registrycom.opensubtitles/mcp-server

So installierst du es

Was es kann

Untertitel für Filme und Serien von OpenSubtitles.com suchen, prüfen und herunterladen.

Automatisch aus der Beschreibung des Herstellers übersetzt · vom Team noch nicht geprüft

  • Verbindung Computer oder Cloud
  • Konto oder Schlüssel Cloud: Geht ohne Schlüssel · X-OpenSubtitles-Username, X-OpenSubtitles-Password, X-OpenSubtitles-Token, Api-Key eintragen, falls vorhanden (oft höhere Limits) · Lokal: Braucht OPENSUBTITLES_PASSWORD
  • Kategorie Spiele, Sport, Essen & Lernen
Originalbeschreibung des Herstellers
Search, inspect and download subtitles for movies and TV from OpenSubtitles.com.

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit15/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert35/100

Qualität: 5/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte OpenSubtitles. Folge https://mcp.popnx.com/i/opensubtitles-mcp-server.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

5/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (mcp.opensubtitles.com) · ✓ Befehle geprüft am 22. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Klick auf diesen Button: Claude öffnet das Fenster zum Hinzufügen bereits ausgefüllt

    OpenSubtitles zu Claude hinzufügen ↗

    Name und URL sind schon eingetragen. Prüfe sie und klick auf Add · bist du abgemeldet, fragt Claude zuerst nach der Anmeldung

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

    Button funktioniert nicht? Selbst ausfüllen

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4

    Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameOpenSubtitles
    Remote MCP server URL · Adressehttps://mcp.opensubtitles.com/mcp
  2. Im Chat einschalten

    +ConnectorsOpenSubtitles

  3. Ausprobieren

    Nutze OpenSubtitles und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es OpenSubtitles nutzt, oder ein Werkzeug von OpenSubtitles in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameOpenSubtitles
    Connection · Adressehttps://mcp.opensubtitles.com/mcp
  3. OpenSubtitles im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen OpenSubtitles aus deinen Plugins wählen

  4. Ausprobieren

    Nutze OpenSubtitles und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es OpenSubtitles nutzt, oder ein Werkzeug von OpenSubtitles in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

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

    OpenSubtitles sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze OpenSubtitles und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es OpenSubtitles nutzt, oder ein Werkzeug von OpenSubtitles in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze OpenSubtitles und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es OpenSubtitles nutzt, oder ein Werkzeug von OpenSubtitles in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze OpenSubtitles und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es OpenSubtitles nutzt, oder ein Werkzeug von OpenSubtitles in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://mcp.opensubtitles.com/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die OpenSubtitles nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das 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"
    }
  }
}

Auf deinem Computer installiert

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"
      }
    }
  }
}

Werte, die du selbst einträgst

  • OPENSUBTITLES_API_KEY geheim env
    Optionaler eigener OpenSubtitles-API-Schlüssel (https://www.opensubtitles.com/consumers); andernfalls wird ein integrierter App-Schlüssel verwendet
    Englisches Original anzeigenOptional own OpenSubtitles API key (https://www.opensubtitles.com/consumers); a built-in app key is used otherwise
  • OPENSUBTITLES_USERNAME env
    Ihr OpenSubtitles-Benutzername, für das Download-Kontingent und den VIP-Status Ihres Kontos
    Englisches Original anzeigenYour OpenSubtitles username, for your account's download quota and VIP status
  • OPENSUBTITLES_PASSWORD geheim erforderlich env
    Ihr OpenSubtitles-Passwort
    Englisches Original anzeigenYour OpenSubtitles password
  • X-OpenSubtitles-Username HTTP header
    Ihr OpenSubtitles-Benutzername; zusammen mit dem Passwort werden Downloads über das Kontokontingent aktiviert
    Englisches Original anzeigenYour OpenSubtitles username; with the password, enables downloads on your account's quota
  • X-OpenSubtitles-Password geheim HTTP header
    Ihr OpenSubtitles-Passwort
    Englisches Original anzeigenYour OpenSubtitles password
  • X-OpenSubtitles-Token geheim HTTP header
    Alternative zu Benutzername/Passwort: ein Login-Token der OpenSubtitles-API
    Englisches Original anzeigenAlternative to username/password: a login token from the OpenSubtitles API
  • Api-Key geheim HTTP header
    Optionaler eigener OpenSubtitles-API-Schlüssel
    Englisches Original anzeigenOptional own OpenSubtitles API key

Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
409/Wo.
Bestätigte Domain
✓ opensubtitles.com
Verbindung
Computer oder Cloud
Transport
stdio, streamable-http
Neueste Versioni
2.0.3
In der Registry veröffentlichti
22. Nov. 2026
Code zuletzt geänderti
22. Nov. 2026
Zuletzt geprüft
22. Nov. 2026
Entwickler
opensubtitles
Pakete
npm: @opensubtitles/mcp-server
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

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

Laufen auf deinem Computer in

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

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 22. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • 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.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 22. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde über die Domain opensubtitles.com bestätigt (die Registry prüft, wem die Domain gehört)

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: heute

  • ✓ Bestanden

    Hat eine Lizenz

    Nutzt MIT

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 356 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 7 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Veröffentlichte Schwachstellen (OSV.dev)

Noch nicht geprüft

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

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

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Spiele, Sport, Essen & Lerneni

  • Mehr Sterne als 91 % der anderen 1720 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 99 % der anderen 1720 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 1720 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist OpenSubtitles sicher?

Er hat 5 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: OPENSUBTITLES_PASSWORD

Läuft er auf meinem Computer oder in der Cloud?

Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt heute geändert, und die neueste Version (2.0.3) kam heute in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: LearnHouse, Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

LearnHouse

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

von learnhouseWeit verbreitet★ 2490Aktualisiert vor 3 Tagen

Läuft in der Cloud✓ vom Dienst · learnhouse.app

Anime Garden

Anime Garden MCP for anime torrent discovery.

von yjl9903Wachsend★ 1414Aktualisiert vor 18 Tagen

Läuft in der Cloud✓ animes.garden

WilmAI

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

von aikarjalWachsend↓ 1399/Wo.★ 89 Sterne des ganzen ReposAktualisiert vor 13 Tagen

Läuft auf deinem Computer✓ vom Dienst · wilm.ai

Lumify Sports Intelligence

Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.

von lumifyaiAm Anfang★ 15Aktualisiert vor 4 Monaten

Läuft in der Cloud✓ vom Dienst · lumify.ai

Savecraft

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

von joshsymondsAm Anfang★ 13Aktualisiert vor 7 Monaten

Läuft in der CloudRepo archiviert✓ vom Dienst · savecraft.gg
Im Vergleich mit ähnlichen
Dieser
OpenSubtitles
LearnHouseAnime GardenWilmAILumify Sports IntelligenceSavecraft
Läuft woIn der Cloud oder auf deinem RechnerLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationWird auf deinem Rechner installiertLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselJaNeinNeinNeinJaNein
Mit + in Claude hinzufügenNeinNeinNeinNeinNeinNein
Basisprüfungen5/55/54/43/34/43/4
LizenzMITAGPL-3.0AGPL-3.0MITMITApache-2.0
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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