MDBList MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MDBLIST_API_KEY | Yes | Your API key from mdblist.com/preferences |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_media_infoA | Get full details (ratings, scores, streams, IDs) for a movie or show by provider ID. Also finds similar titles: append "recommendations" for up to ~8 related movies/shows (sparse for niche titles). |
| get_watch_providersA | Get direct streaming/watch-provider links for a movie or show (supporter feature; empty for others). May be rejected for API-key access; get_media_info also lists providers. |
| search_mediaC | Search movies and shows by title. |
| get_ratingsA | Get one rating source for many movies or shows at once. Max 10 IDs per call (100 for supporters). |
| discover_catalogC | Browse the movie or show catalog with filters and sorting. |
| get_genresA | List available genres (use the slugs to filter catalogs and lists). |
| get_personA | Get details of a person (actor, director, …) by TMDb person ID. |
| get_favorite_peopleA | Get the user's favorited people, or (upcoming=true) upcoming movies/episodes featuring them. |
| favorite_personB | Add a person to the user's favorites (subject to a tier-based limit). |
| unfavorite_personC | Remove a person from the user's favorites. |
| get_user_listsA | List the authenticated user's MDBList-made lists, or another user's public lists. Excludes lists imported from IMDb, Trakt or Letterboxd: use browse_lists with source 'external' for those. |
| browse_listsA | Browse lists: top public lists, curated lists, your liked lists, official MDBList lists, or your connected external lists. |
| search_listsB | Search public lists by title. |
| get_listB | Get metadata (name, owner, item count, likes) of a list. |
| get_list_itemsA | Get the movies and shows in a list, with filtering, sorting and pagination. |
| get_list_membershipB | Find which of the user's static lists contain a movie, show, season or episode. |
| add_list_itemsB | Add movies/shows to one of the user's static lists. |
| remove_list_itemsB | Remove movies/shows from one of the user's static lists. |
| create_listC | Create a new static list for the user. |
| delete_listA | Permanently delete one of the user's static lists (dynamic, official and external lists cannot be deleted). |
| get_watchlistB | Get the authenticated user's watchlist items. |
| add_watchlist_itemsC | Add movies/shows to the user's watchlist. |
| remove_watchlist_itemsB | Remove movies/shows from the user's watchlist. |
| get_syncB | Get the user's watched history, ratings, collection, dropped shows or dropped seasons. |
| get_last_activitiesB | Get timestamps of when the user last changed watched items, ratings and other sync data. |
| get_item_stateA | Get watched, rated, collected and watchlist state for up to 100 movies, shows or episodes. |
| get_up_nextA | Get next episodes: next (in-progress shows), upcoming (caught-up shows airing soon), upcoming_episodes (every followed show) or watchlist (watchlisted shows). |
| rate_mediaB | Add or update the user ratings of movies/shows. |
| remove_ratingsA | Remove the user ratings of movies/shows (watched status is kept). |
| mark_watchedB | Mark movies or whole shows as watched for the user. |
| unmark_watchedA | Remove the watched status of movies or whole shows (ratings are kept). |
| get_userA | Get the authenticated user's profile, supporter status and API rate limits, or another user's public profile. |
| get_user_statsA | Get the authenticated user's precalculated watch statistics. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 33 tools
Most tools map to a clear resource+action (list CRUD, watchlist, favorites, ratings, sync, discovery), and descriptions explicitly distinguish near-neighbors such as get_user_lists vs browse_lists and get_ratings vs rate_media. A few pairs still blur: get_watch_providers vs get_media_info (providers), get_sync vs get_item_state vs get_user_stats, and get_watchlist vs get_up_next's watchlist mode.
Every tool is snake_case verb-first (get_*, search_*, add_*_items, remove_*, create_list, delete_list, mark_watched, rate_media), forming a predictable pattern. Minor asymmetries like favorite_person/unfavorite_person without a get_ prefix are still consistent verb_noun forms.
33 tools is heavy and above the comfortable range, driven by a genuinely broad domain (media, lists, watchlist, sync, ratings, people, discovery). Each tool does map to a real API operation, but several could be consolidated or folded into existing ones (e.g. get_ratings vs get_media_info, get_watch_providers vs get_media_info).
Coverage is strong: list lifecycle CRUD plus membership, watchlist add/remove/get, watched state, ratings, sync history, stats, favorites and discovery are all present. Gaps remain minor: no list metadata update/rename, no people search (only lookup by TMDb ID), and rate_media appears limited to movies/shows rather than episodes.