ČSFD

What the ČSFD MCP server does

The ČSFD MCP server exposes data from ČSFD.cz for use by compatible AI clients. Its source package, node-csfd-api, is an unofficial TypeScript library that combines scraping, API, export, CLI, and MCP functionality in one project.

The available data covers films and television series, creators, ČSFD users, ratings, and reviews. Film or series records can include titles, release information, descriptions, genres, origins, ratings, posters, creators, tags, video-on-demand links, and premiere information. Creator records can include biographies, birth information, photos, and filmographies.

How it works

The ČSFD MCP server obtains information from ČSFD.cz and makes it available to an LLM through the package’s MCP support. The underlying library uses promise-based, asynchronous methods and accepts numeric IDs, slugs, or full ČSFD URLs for movies, creators, and users.

Search accepts a text query and returns separate result groups for movies, television series, and users. A movie lookup returns detailed metadata for a film or series. Creator lookup provides biographical and filmography data, while user lookups can retrieve ratings and reviews using the relevant user identifier or slug.

The repository documents use with Claude Desktop. The same package also supports direct Node.js use and can run in environments including browsers, serverless platforms, Docker, and macOS or Linux command-line workflows, although those are package capabilities rather than MCP client requirements.

Setup and configuration

Install the package with npm:

npm install node-csfd-api

The README identifies the MCP server as part of the installed package and shows Claude Desktop as a supported use case. The provided material does not include a specific MCP configuration block, command, transport setting, or required environment variable, so those details should be taken from the repository’s current MCP documentation.

The package supports both ESM and CommonJS in Node.js. Its regular library interface uses imports such as import { csfd } from 'node-csfd-api'; and asynchronous calls such as csfd.movie(535121) or csfd.search('Tarantino').

Tools and capabilities

The ČSFD MCP server is suited to agent tasks that need to:

• Search ČSFD for films, series, creators, and users.
• Retrieve a movie or series by ID, slug, or URL.
• Read creator biographies and filmographies.
• Retrieve a user’s ratings.
• Retrieve a user’s reviews.
• Inspect ratings, genres, cast, crew, release details, and related metadata when returned by ČSFD.cz.

The README’s underlying API examples name the operations movie, search, creator, userRatings, and userReviews. Returned values are typed TypeScript objects, and request options can be supplied to the documented library methods.

Limitations and notes

The ČSFD MCP server is an unofficial interface to ČSFD.cz, not an official ČSFD product. Results depend on the source website and the fields available there. The README mentions browser-verification cookies as an API topic, but the provided material does not explain when a cookie is needed or how to configure one.

The supplied documentation confirms Claude Desktop support but does not name Cursor or other MCP clients. It also does not specify authentication, rate limits, an MCP transport, or a dedicated list of MCP tool names beyond the corresponding library operations.