search_imdbLABSCO SUMMARY
Paged five at a time, on purpose.
Every collection tool returns 5 items per page with a start parameter and totalCount / hasMore / nextStart metadata, so browsing a chart costs several small calls instead of one payload the model has to wade through. Responses are cached in memory for 10 minutes by default, which keeps repeat questions off your RapidAPI quota — that cache is lost when the server restarts.
What it is
A Python server over the IMDb API on RapidAPI, covering title search and details, cast and crew, the IMDb charts, upcoming releases by country, and a dedicated set for Indian cinema.
What you get
search_imdbwith filtering, andget_imdb_detailsfor one title by its IMDb id- Credits —
get_directors,get_cast,get_writers - The charts —
get_top_250_movies,get_most_popular_movies,get_top_250_tv_shows,get_most_popular_tv_shows,get_top_box_office_us - Release calendars —
get_upcoming_releasesby country code, withget_country_codes_for_upcoming_releasesto find the right code - Indian cinema —
get_top_rated_malayalam_movies,get_trending_tamil_movies,get_trending_telugu_movies,get_top_rated_indian_movies,get_upcoming_indian_movies - Vocabulary lookups so your filters are valid —
get_types,get_genres,get_countries,get_languages
Requirements
A RapidAPI account subscribed to the IMDb API, with the key in RAPID_API_KEY_IMDB for stdio mode. Python 3.13 or higher; run uv run imdb-server, or use the Docker image, which serves HTTP on port 8081.
Setup effort
One command plus a key — npx -y @smithery/cli install @uzaysozen/imdb-mcp-server --client claude, then supply credentials
USE CASES
01
Settling a question about a film mid-conversation
Search by title, then pull the details, the director and the cast for the one you meant.
02
Building a watchlist from the charts
Page through the top 250 or the most popular titles five at a time, using start to move down the list.
03
Finding what is out soon where you live
Look up the country code first, then ask for upcoming releases filtered to movies or shows.
04
Writing a search filter that returns something
Read the valid content types, genres, countries and languages before you filter on them.
23 tools
Listed in project docs. Your client may show a different list.
get_imdb_detailsget_directorsget_castget_writersget_typesget_genresget_countriesget_languagesget_top_250_moviesget_top_box_office_usget_most_popular_moviesget_top_250_tv_showsget_most_popular_tv_showsget_upcoming_releasesget_country_codes_for_upcoming_releasesget_top_rated_malayalam_moviesget_upcoming_indian_moviesget_trending_tamil_moviesget_trending_telugu_moviesget_top_rated_tamil_moviesget_top_rated_telugu_moviesget_top_rated_indian_moviesBEFORE YOU INSTALL
What to know first
Tools you get
23 tools named in the project's documentation.
Requires
- uv on PATH
- Python 3.13 or later
- RAPID_API_KEY_IMDB in your environment
INSTALLATION
Connect your client
Server setup
Claude Desktop — Smithery
TERMINAL
npx -y @smithery/cli install @uzaysozen/imdb-mcp-server --client claudeMCP Clients
Claude Desktop — uv
CLAUDE DESKTOP — UV · JSON
{
"mcpServers": {
"imdb_server": {
"command": "uv",
"args": [
"--directory",
"<YOUR_PATH_TO_IMDB_MCP_SERVER>",
"run",
"imdb-server"
],
"env": {
"RAPID_API_KEY_IMDB": "<YOUR_RAPID_API_KEY_IMDB>"
}
}
}
}
