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.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@IMDB MCP ServerWho was in the cast of Inception?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
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 installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.