IMDb MCP Server

Verified on MCP Review

A Python server implementing Model Context Protocol (MCP) for movie and TV show information using the IMDb API service.

Table of Contents

• Overview
• Features
• Requirements
• Configuration
• Tools
  • Search Tools
  • IMDb ID Tools
  • Configuration Tools
  • Movies Tools
  • TV Shows Tools
  • Upcoming Releases Tools
  • India Spotlight Tools
• Example Prompt and Response
• Installation
• Starting the Server
• Technical Details
  • Transport Modes
  • Pagination System
  • Caching System
• Limitations
• Troubleshooting
• License

Overview

This server provides a comprehensive set of tools for accessing IMDb data through the IMDb API. It serves as a bridge between agents and the IMDb database, offering detailed information about movies, TV shows, actors, directors, and more.

Features

• 🎬 Movie and TV show search capabilities
• 📋 Detailed information about movies and TV shows
• 👨‍👩‍👧‍👦 Cast and crew information
• 🏆 Top-rated and popular content lists
• 💰 Box office data
• 🌍 Country-specific movie information (with special focus on Indian cinema)
• 🔜 Upcoming releases
• 🔄 Efficient response caching system

Requirements

• Python: 3.13 or higher
• Package Manager: uv (recommended) or pip
• RapidAPI Account: Required for IMDb API access

Configuration

This server requires an API key from RapidAPI for the IMDb API service:

1. Create an account on RapidAPI

2. Subscribe to the IMDb API on RapidAPI

3. Configure the API key using one of these methods:

   Method 1: Smithery Configuration (for HTTP mode)

   • When installing via Smithery, provide your API key through the Smithery configuration system
   • The key is passed per-request, allowing for multi-user scenarios

   Method 2: Environment Variable (for stdio mode)

   export RAPID_API_KEY_IMDB=your_api_key_here
   

Tools

Search Tools

| Tool | Description | Example | |------|-------------|---------| | search_imdb | Search for movies and TV shows with various filtering options | search_imdb(primary_title="Inception") |

IMDb ID Tools

| Tool | Description | Example | |------|-------------|---------| | get_imdb_details | Retrieve detailed information about a movie or TV show | get_imdb_details(imdb_id="tt1375666") | | get_directors | Retrieve the directors of a movie | get_directors(imdb_id="tt1375666") | | get_cast | Retrieve the cast of a movie | get_cast(imdb_id="tt1375666") | | get_writers | Retrieve the writers of a movie | `get_writers(imdb_id="

... View full README on GitHub