mcp-justwatch

# MCP JustWatch Server A Model Context Protocol (MCP) server built to provide access to JustWatch streaming availability data. Search for movies and TV shows and find out where they're available to stream across different platforms and countries. ## Features - **Search Content**: Search for movies and TV shows by title with detailed metadata - **Streaming Availability**: Get comprehensive information about where content is available to stream - **Multi-Country Support**: Query streaming availability across multiple countries simultaneously - **Detailed Information**: Access IMDb/TMDb scores, genres, runtime, release dates, and more - **Offer Details**: Get pricing, quality (HD/4K), and direct URLs to streaming platforms ## Technology Stack This server is built using: - **[FastMCP](https://github.com/jlowin/fastmcp)**: A modern, decorator-based framework for building MCP servers with minimal boilerplate - **[simple-justwatch-python-api](https://github.com/Electronic-Mango/simple-justwatch-python-api)**: GraphQL-based wrapper for the JustWatch API ## Installation ### Prerequisites - Python 3.10 or higher - pip or uv package manager ### From Source 1. Clone the repository: ```bash git clone <repository-url> cd mcp-justwatch ``` 2. Install the package: ```bash pip install -e . ``` Or using `uv`: ```bash uv pip install -e . ``` ### For Development Install with development dependencies: ```bash pip install -e ".[dev]" ``` ## Usage ### As an MCP Server This server is designed to be used with MCP clients. Add it to your MCP client configuration: #### Claude Desktop Configuration Add to your `claude_desktop_config.json`: ```json { "mcpServers": { "justwatch": { "command": "python", "args": ["-m", "mcp_justwatch.server"] } } } ``` Or if installed in a virtual environment: ```json { "mcpServers": { "justwatch": { "command": "/path/to/venv/bin/python", "args": ["-m", "mcp_justwatch.server"] } } } ``` #### O…