IMDB MCP Server
Provides access to IMDb data, enabling movie and person searches, retrieval of detailed film and cast information, and access to the IMDb Top 250 movies list.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
IMDB MCP Server
A cloud-runnable JSON-RPC service that provides access to IMDB data. Designed to work with LLMs via the MCP (Model Context Protocol).
How It Works
LLM Configuration: Add the MCP server URL to your LLM's configuration
Discovery: The LLM queries the server URL to understand available tools
Query: The LLM sends JSON-RPC requests to fetch IMDB data
Response: The server returns structured data that the LLM interprets and explains to users
Related MCP server: MCP TMDB
Endpoints
Endpoint | Method | Description |
| GET | HTML documentation (human-readable) |
| GET | Service information (JSON) |
| POST | JSON-RPC 2.0 endpoint |
| POST | MCP protocol endpoint for LLM tool calling |
| GET | Health check for cloud deployments |
Available Tools
Tool | Description | Parameters |
| Search movies by title |
|
| Get full movie info |
|
| Search actors/directors |
|
| Get person info/filmography |
|
| Get IMDB Top 250 |
|
| Get cast of a movie |
|
JSON-RPC Usage
Send a POST request to /jsonrpc:
{
"jsonrpc": "2.0",
"method": "search_movies",
"params": {"query": "The Matrix", "limit": 5},
"id": 1
}Response:
{
"jsonrpc": "2.0",
"result": [
{"id": "0133093", "title": "The Matrix", "year": 1999},
{"id": "0234215", "title": "The Matrix Reloaded", "year": 2003}
],
"id": 1
}LLM MCP Configuration
Add to your LLM's MCP server configuration:
{
"mcpServers": {
"imdb": {
"url": "https://your-deployed-url.com/mcp",
"transport": "http"
}
}
}Local Development
Run locally
pip install -r requirements.txt
python app.pyServer runs at http://localhost:8080
Run with Docker
docker build -t imdb-mcp .
docker run -p 8080:8080 imdb-mcpCloud Deployment
Cloud Foundry
cf pushUses manifest.yaml configuration.
SAP BTP (Cloud Foundry)
# Build MTA archive
mbt build
# Deploy
cf deploy mta_archives/imdb-mcp-server_1.0.0.mtarUses mta.yaml configuration.
Heroku
heroku create imdb-mcp-server
git push heroku mainUses Procfile and runtime.txt.
Docker (Any Cloud)
# Build
docker build -t imdb-mcp .
# Run
docker run -p 8080:8080 imdb-mcp
# Push to registry
docker tag imdb-mcp your-registry/imdb-mcp:latest
docker push your-registry/imdb-mcp:latestGoogle Cloud Run
gcloud run deploy imdb-mcp \
--source . \
--platform managed \
--allow-unauthenticatedAWS App Runner / ECS
Use the Dockerfile with your preferred AWS container service.
Project Structure
imdb-mcp/
├── app.py # FastAPI JSON-RPC server
├── imdb_backend.py # Cinemagoer wrapper
├── server.py # FastMCP server (for local MCP)
├── requirements.txt # Python dependencies
├── pyproject.toml # Project metadata
├── Dockerfile # Container image
├── Procfile # Heroku/PaaS process file
├── runtime.txt # Python version
├── manifest.yaml # Cloud Foundry manifest
├── mta.yaml # SAP BTP MTA descriptor
├── .dockerignore # Docker ignore patterns
└── .cfignore # Cloud Foundry ignore patternsEnvironment Variables
Variable | Default | Description |
| 8080 | Server port |
Notes
Cinemagoer queries IMDB via web scraping, responses may be slower than API-based solutions
For non-commercial use only (per IMDB terms of service)
No API key required
This server cannot be deployed
Maintenance
Related MCP Connectors
YouTube transcripts, IMDb search and podcast search as agent tools.
Web data for agents. Extract web pages, crawl websites, discover URLs, and search the web.
The media memory layer for AI agents and their humans. Your AI client can search your collection, add and log what you've finished, update ratings and lists, and find patterns across everything you've read, watched, played, and listened to.
Intelligent context infrastructure for AI teams: knowledge graph, sessions, tasks, documents.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to search and retrieve movie information from The Movie Database (TMDB) API through the Model Context Protocol interface.84 npm2MIT
- AlicenseNot gradedqualityDmaintenanceAn implementation of the Model Context Protocol that provides tools to interact with The Movie Database (TMDB), allowing users to search for movie collaborations, actor filmographies, and other film industry data.6MIT
- AlicenseNot gradedqualityBmaintenanceEnables LLMs to query movie details, search, creator info, user ratings, and reviews from the Czech-Slovak Film Database (CSFD.CZ) via the Model Context Protocol.1,181 npm66MIT
- AlicenseNot gradedqualityBmaintenanceEnables searching and retrieving detailed information about movies, TV shows, and people from The Movie Database (TMDB), including streaming availability, via the Model Context Protocol.377 npm3Apache 2.0