imdb

This IMDb MCP Server provides a Python-based MCP interface to access IMDb data via the IMDb API. It exposes a rich set of tools for searching movies and TV shows, retrieving details, and listing top titles, upcoming releases, and country-specific information. The server acts as a bridge between agents and the IMDb API, offering endpoints for search, details, cast/crew data, and curated lists such as top rated or most popular content. You can interact with it through the documented MCP tools, sending prompts that call specific tools (e.g., search_imdb, get_imdb_details, get_top_250_movies) and receive structured responses that integrate smoothly with agents and workflows.

Prerequisites:

• Python 3.13 or higher installed on your system
• Access to the IMDb API via RapidAPI (requires a RapidAPI account and a subscription to the IMDb API)
• A RapidAPI key for the IMDb API
• Optional: Smithery for HTTP mode configuration

Install and run (UV-based Python runtime):

1. Install Python 3.13+ from the official source.
2. Ensure you have package manager access to install Python tools.
3. Install the UV runtime tool (used to run MCP servers):
   • For many setups: pip install uvx
4. Set your API key for IMDb access:
   • For per-request Smithery mode (HTTP): configure via Smithery if you are using Smithery as described in the docs
   • For stdio mode (local run): export RAPID_API_KEY_IMDB=your_api_key_here
5. Start the server:
   • uvx imdb-mcp-server

Notes:

• If you prefer Smithery-based HTTP mode, follow the Smithery configuration steps and provide the API key in Smithery's configuration system.
• The server expects the RAPID_API_KEY_IMDB environment variable when running in stdio mode.

Environment variables and configuration options:

• RAPID_API_KEY_IMDB: Your IMDb API key from RapidAPI. Required for stdio mode. Can be provided per-request via Smithery in HTTP mode.
• If using Smithery, keys are managed through Smithery configuration and passed per request. Common issues:
• Invalid or missing API key: Ensure RAPID_API_KEY_IMDB is set correctly or Smithery configuration is providing it per request.
• Network or rate limit errors from IMDb API: Check your RapidAPI subscription limits and ensure your key is active.
• If the server fails to start with uvx, verify that uvx is installed and the package name imdb-mcp-server matches what you provide in the mcpServers config.