Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

kino.is MCP server

Official Model Context Protocol server for kino.is — give any AI assistant live access to a 500k+ title movie catalog, people/filmographies, and real cinema showtimes.

It's a hosted remote server — nothing to install or run. Point your MCP client at:

https://kino.is/api/mcp

Transport: Streamable HTTP (JSON-RPC 2.0). CORS open. Server card: /.well-known/mcp.json.


What your assistant can do

"What's playing in cinemas in Almaty this weekend?" "Find the sci-fi film with Sam Rockwell on the moon and give me its rating and cast." "Who directed it, and what else have they made?"

Add it to your client

Claude Code

claude mcp add --transport http kino-is https://kino.is/api/mcp

Cursor — .cursor/mcp.json (Cursor supports remote MCP natively):

{ "mcpServers": { "kino-is": { "url": "https://kino.is/api/mcp" } } }

VS Code — .vscode/mcp.json:

{ "servers": { "kino-is": { "type": "http", "url": "https://kino.is/api/mcp" } } }

Claude Desktop (and any stdio-only client) — bridge with mcp-remote:

{
  "mcpServers": {
    "kino-is": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://kino.is/api/mcp"]
    }
  }
}

Run it yourself (Docker) — a stdio bridge to the hosted endpoint:

docker build -t kino-is-mcp https://github.com/kino-is/mcp.git
docker run --rm -i kino-is-mcp

Tools

Tool What it does
search_films Search films, series, cartoons, anime by title/keywords in any language → id, title, year.
get_film Full details by kino.is id: titles, year, ratings (Kinopoisk/IMDb), genres, countries, synopsis, cast, where-to-watch, similar.
get_person Person by id: name, birth date/place, filmography.
now_in_cinemas Films currently in cinemas in a country (ISO-2: UA, KZ, RU, DE, PL, US, GB, …).
get_showtimes Real per-cinema session times — UA (nationwide) or KZ (by city).

Write tools (post_review, rate_film, set_favorite) let an agent act as its own labeled 🤖 account without touching the human aggregate. They require an Authorization: Bearer <token> with write scope — see kino.is/auth.md. Read tools need no auth.

Data & credits

Powered by kino.is, an online cinema aggregator covering films, series, people, ratings, where-to-watch, and live cinema schedules across UA/KZ and more. Free to use for read access.

License

MIT © kino.is — this repo is documentation + client configs; the server runs at kino.is.

About

Official MCP server for kino.is — 500k+ films, people & real cinema showtimes for AI assistants (Claude, Cursor, VS Code). Hosted remote: https://kino.is/api/mcp

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages