# ČSFD MCP server

> Lets an AI client access movies, TV series, creators, and user ratings from the Czech-Slovak film database.

- Repository: https://github.com/bartholomej/node-csfd-api
- Page: https://hostedmcp.org/servers/bartholomej/node-csfd-api
- Transport: stdio
- Stars: 66
- License: MIT
- Latest version: 5.16.0

## Install

### Claude Code

```sh
claude mcp add node-csfd-api -- npx -y node-csfd-api
```

### Cursor (`~/.cursor/mcp.json`)

```json
{
  "mcpServers": {
    "node-csfd-api": {
      "command": "npx",
      "args": [
        "-y",
        "node-csfd-api"
      ]
    }
  }
}
```

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "node-csfd-api": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "node-csfd-api"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"node-csfd-api","type":"stdio","command":"npx","args":["-y","node-csfd-api"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "node-csfd-api": {
      "command": "npx",
      "args": [
        "-y",
        "node-csfd-api"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add node-csfd-api -- npx -y node-csfd-api
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.node-csfd-api]
command = "npx"
args = ["-y", "node-csfd-api"]
```

### Gemini CLI

```sh
gemini mcp add -s user node-csfd-api npx -- -y node-csfd-api
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "node-csfd-api": {
      "command": "npx",
      "args": [
        "-y",
        "node-csfd-api"
      ]
    }
  }
}
```

## Tools (8)

- `search`: Searches for a movie, TV series, or person on CSFD.cz. Returns a list of results with IDs. Use this tool FIRST to find the ID needed for other tools. (read-only)
- `get_movie`: Retrieves detailed information about a specific movie or series, including rating, plot, genres, and actors. Requires a numeric CSFD ID. (read-only)
- `get_creator`: Retrieves information about a specific creator (actor, director, etc.), including their biography and filmography. Requires a numeric CSFD ID. (read-only)
- `get_user`: Retrieves a CSFD user's public profile: nickname, real name, location, member since, and the total number of ratings, reviews and fans. Use get_user_ratings or get_user_reviews for the ratings and reviews themselves. (read-only)
- `get_user_ratings`: Retrieves movie ratings from a specific CSFD user. Returns a list of movies with their user rating (0-5 stars). Supports pagination and filtering by film type. (read-only)
- `get_user_reviews`: Retrieves movie reviews written by a specific CSFD user. Returns a list of movies with their review text and rating. (read-only)
- `get_cinemas`: Retrieves cinema screenings for a given district in Czech Republic. Returns a list of cinemas with their current screenings, showtimes, and movie names and ids. (read-only)
- `get_chart`: Retrieves one of CSFD's charts of movies or TV series: the best or worst rated, the most favourite or the most controversial. Returns the places in order with ID, title, year, rating, genres, countries, directors and actors. Without a limit it returns the first page, places 1–99, in one request to CSFD; each further hundred costs another request. (read-only)

## FAQ

### What can I search for using this server?

You can search for movies, TV series, creators, and users across the ČSFD database.

### Can I get information about specific film creators?

Yes, you can retrieve detailed information about a creator, including their biography and filmography.

### Does it support movie charts?

Yes, it provides access to ČSFD's charts for the best, worst, most favourited, and most controversial movies and series.
