# Rollekino MCP server

Read and write the film archive at [rollekino.fi](https://www.rollekino.fi): about 3400 reviewed films, each with a personal 1-10 rating alongside IMDb and Metascore.

Runs on the same host as the site, served at `https://www.rollekino.fi/mcp` by nginx in front of the Python server on 8600 and its OAuth login on 8602. It is not WordPress and exposes only film tools.

> [!WARNING]
> Using this server with a paid AI service costs money. Tool definitions and results are billed as input tokens, and an agent can call tools repeatedly on its own. You are responsible for every charge, so set spending limits with your provider. The author accepts no liability for any costs. See [DISCLAIMER.md](DISCLAIMER.md).

## Tools

Reading: `search_films`, `get_film`, `list_films`, `get_stats`, `list_terms`, `list_queue`, `get_connection_status`.

Writing: `set_rating`, `write_review`, `create_film`, `trash_film`, `lookup_tmdb`.

`list_films` filters by year, genre, director, actor and rating range, orders by rating, title or date, and paginates.

## The site side

The film data comes from `rollekino/v1`, added to the theme in `inc/hooks/movies-api.php`. Writes go through that namespace rather than `/wp/v2/movie`, because the theme registers a REST field named `meta` for the Vue archive which shadows core's meta object.

`create_film` with a `tmdb_id` enriches from TMDB and OMDB using the helpers in `inc/movie-enrich.php`, shared with `quick-review.php`, so a film created here renders identically to one posted from the quick review page.

## Setup

```bash
uv venv && uv pip install -e .
```

```bash
export ROLLEKINO_URL=https://www.rollekino.fi
export ROLLEKINO_USER=...              # WordPress user with edit_posts
export ROLLEKINO_APP_PASSWORD=...      # application password
```

Reads are public; only writes need the credentials.