OpenSubtitles MCP Server Logo

OpenSubtitles MCP Server

Official

Enables searching and downloading subtitles from OpenSubtitles.com through their API. Supports compr...

7 views
0 installs
Updated Jan 21, 2026
Not audited
Enables searching and downloading subtitles from OpenSubtitles.com through their API. Supports comprehensive search by movie title, IMDB/TMDB ID, file hash, and TV show episodes with multiple subtitle formats (SRT, ASS, VTT).
  1. Click the "Install Now" button in the FastMCP connection interface to open the environment-variables (ENV) form.
  2. Create an OpenSubtitles account: register/sign in at OpenSubtitles.com. (opensubtitles.com)
  3. Create an API consumer (application) in your OpenSubtitles account to obtain your API key:
    • After signing in, open the "API Consumers" / "Consumers" / "Developers" section of your account.
    • Create a new consumer (give it a name and optional description) and copy the API key that is generated. (github.com)
  4. In the FastMCP ENV form (opened by "Install Now"), paste the key into the environment variable field(s):
    • For the MCP server runtime use OPENSUBTITLES_USER_KEY = <your_api_key> (used by the MCP server).
    • If your integration specifically expects OPENSUBTITLES_API_KEY (e.g., n8n workflows), set OPENSUBTITLES_API_KEY = <your_api_key>.
    • Optional: if you need a custom gateway, set OPENSUBTITLES_API_BASE = <base_url> (defaults to https://api.opensubtitles.com).
  5. (Optional) If you plan to do authenticated downloads at scale, consider VIP/tier limits on downloads and upgrade in your OpenSubtitles account if needed. (github.com)
  6. Save the ENV values in the FastMCP connection interface (click Save / Apply in the Install Now dialog).
  7. Verify the key works:
    • Use the MCP test UI or call the server tool "search_subtitles" (no key required for search) and then "download_subtitle" supplying your OPENSUBTITLES_USER_KEY / OPENSUBTITLES_API_KEY if prompted.
    • Confirm a successful authenticated download (or check server logs for "Invalid API key" / success messages).
  8. If you see any authentication errors, re-check the API key in your OpenSubtitles account (Regenerate if needed), re-paste it into the FastMCP ENV form, save, and re-test.

Quick Start

View on GitHub

More for Entertainment and Media

View All →

More for API Development

View All →

Report Issue

Thank you! Your issue report has been submitted successfully.