guessit-js
Server Details
Parse movie and TV filenames: title, year, season, episode, codecs, languages, release group.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- opensubtitles/guessit-js
- GitHub Stars
- 14
- Server Listing
- guessit-js
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 3 tools
The three tools map to clearly separate modes of use: single-string parsing (guessit), bulk parsing (guessit_batch), and schema introspection (guessit_properties). An agent can tell instantly which one to call based on whether it has one filename, many filenames, or needs the value vocabulary.
All names share a single 'guessit' root with consistent snake_case suffixes (_batch, _properties) for the variants. The only minor deviation is the bare base name for the primary tool, which is predictable rather than confusing.
Three tools is well-matched to a focused filename-parsing library: one core parser, one batch wrapper, one schema reference. Nothing feels redundant or missing from a surface-area standpoint.
Single, batch, and property-enumeration coverage gives a full parse lifecycle for the domain, including the schema needed to interpret outputs. The only gap is no explicit way to pass or discover advanced parsing options beyond the mention of 'same options' in the batch tool.
Publisher details
- Operator
- OpenSubtitles · Publisher source
- Operator website
- https://www.opensubtitles.com · Publisher source
- Vendor relationship
- First-party · Publisher source
- Privacy policy
- https://www.opensubtitles.com/tos · Publisher source
- Trust center
- Not available
- Restrictions
- No account or API key needed. The hosted endpoint is a free demo tier with a daily request cap, not meant for heavy production use; for unlimited use run it locally with npx -y guessit-js --mcp (offline). · Publisher source
Available Tools
3 toolsguessitParse a media filenameARead-onlyIdempotentInspect
Extract metadata from one movie or TV episode filename or release name: title, year, season, episode, episode_title, screen_size, source, video_codec, audio_codec, language, subtitle_language, release_group, streaming_service, container, type (movie or episode) and more (56 properties). Output matches Python guessit's JSON. Pass just the file name or a full path; directory names help (e.g. "Show/Season 2/episode.mkv").
Inputs: filename (required), options. Returns: Python guessit JSON: only the properties found; several values become an array.…
guessit_batchParse many media filenamesARead-onlyIdempotentInspect
Parse up to 100 filenames in one call with the same options. Returns one entry per name, in order: {input_string, result} or {input_string, error}. Faster than calling guessit repeatedly.
Inputs: filenames (required), options. Returns: results
guessit_propertiesList guessit propertiesARead-onlyIdempotentInspect
List every property guessit can return with its possible values (enum values such as source: ["Blu-ray", "Web", ...]; [null] for free-form ones such as title).
Inputs: no named parameters. Returns: Property name -> possible values
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Parse WebVTT, SRT, or TTML for conformance, timing, overlaps, line length, and reading speed.
Unofficial Movies MCP — wraps iTunes Search API (movies, free, no auth) and TVmaze API (TV shows…
Extract text, pages and metadata from PDFs in bulk, with OCR for scanned files.
Convert subtitles, transcripts, broadcast captions (SCC/MCC/STL), EDLs, and Premiere files.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides tools for AI clients to scan, match, and scrape TMDB metadata for local media files, with safe sidecar writing or full Jellyfin-style reorganization including file renaming and NFO generation.MIT

TorrentClaw-MCPofficial
AlicenseAqualityCmaintenanceGiving AI assistants the ability to search movies and TV shows, find torrents with magnet links, check streaming availability, and explore cast/crew metadata.521052 npm18MIT- AlicenseNot gradedqualityCmaintenanceEnables movie and TV lookups through twelve read-only tools: title and person search, full details, episode lists, discovery by genre/year/language/streaming service, trending and recommendations, where to watch by country, and merged critic/audience scores from IMDb, Rotten Tomatoes, Metacritic, Letterboxd and others. Runs as a local stdio server or a containerized Streamable HTTP service with bearer auth.1MIT
- AlicenseAqualityBmaintenanceEnables natural-language clients to manage a personal torrent queue pipeline, including IMDb list candidate discovery, OMDb title lookups, Jackett indexer search, and qBittorrent RSS queue operations.18MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.