Skip to main content
Glama
smeet666

mcp-tvsubtitles

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
TVS_BUDGET_MSNoDeadline for one read, its retries included.60000
TVS_LOG_LEVELNoWhat reaches stderr.error
TVS_TIMEOUT_MSNoDeadline for one attempt.20000
TVS_USER_AGENTNoPrepended to this server's own agent, which stays attached.
TVS_MAX_RETRIESNoAttempts after the first.3
TVS_CACHE_TTL_MSNoHow long a page is held in memory. 0 turns the store off.900000
TVS_MAX_BODY_BYTESNoThe largest answer read for one page.8000000
TVS_MIN_INTERVAL_MSNoMilliseconds between two requests. 1500 is a floor.2000
TVS_CACHE_MAX_ENTRIESNoPages held before the least recently used is dropped.200

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_titlesA

Search tvsubtitles.net for a television series by name. The site catalogues television only, so 'media_type' takes 'tv' or 'any' and a film is refused rather than answered with an absence. Each row carries the id the other tools take, the years the site publishes for the show, and the languages it draws a flag for. Pass 'with_counts' for how many subtitles, episodes and seasons the site holds per show: it publishes those three on its catalogue index rather than on the page a search answers with, so reading them costs one further request over a large page, and each counts the whole show. Show ids come from here and are never built by hand.

list_subtitlesA

List what tvsubtitles.net holds for one series. Pass 'id' from search_titles. With 'season' alone the answer is that season's coverage, one row per episode saying which languages hold something, and 'kind' reads 'coverage'. Add 'episode' and the answer is the subtitle records themselves, with 'kind' reading 'subtitles'. Leaving 'season' out reads the newest season, and the answer says which one that was. This server reads the catalogue: each record carries the page to open to download it.

get_subtitleA

Read one subtitle's record on tvsubtitles.net, from an id list_subtitles returned. The record carries the episode it belongs to, the release it was cut for, who uploaded it and when, its size and how often it was downloaded. Six of the site's ten fields are absent on some records, the author on roughly two out of three, and an absent field is null rather than blank. This server reads the catalogue: open 'page_url' to download the file.

list_languagesA

List the languages tvsubtitles.net catalogues subtitles in. Called without arguments it returns the twenty-four the catalogue holds. Pass a show id from search_titles to read the languages that show actually holds, measured over one season and counted in episodes. Each entry carries the name the site prints, the two-letter code it addresses the language by, and the BCP 47 tag where that mapping is certain. Six of the site's codes differ from ISO 639-1 and one of them collides: the site writes 'br' for Brazilian Portuguese, which ISO assigns to Breton. Read this before narrowing list_subtitles by language.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/smeet666/mcp-tvsubtitles'

If you have feedback or need assistance with the MCP directory API, please join our Discord server