omdb-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| OMDB_API_KEY | Yes | Your OMDb API key (required) | |
| OMDB_BASE_URL | No | Override OMDb API base URL | https://www.omdbapi.com/ |
| OMDB_MCP_HOST | No | HTTP bind address | 127.0.0.1 |
| OMDB_MCP_PATH | No | HTTP mount path | /mcp |
| OMDB_MCP_PORT | No | HTTP port | 8087 |
| OMDB_MCP_LOG_LEVEL | No | Log level (DEBUG, INFO, WARNING, ERROR) | INFO |
| OMDB_MCP_TRANSPORT | No | Transport mode: stdio or http | stdio |
| OMDB_MCP_AUTH_TOKEN | No | Bearer token for HTTP auth (optional) | |
| OMDB_REQUEST_TIMEOUT | No | OMDb HTTP timeout in seconds | 10 |
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
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_moviesA | Search OMDb for movies/series/episodes by free-text title. |
| get_by_titleA | Look up a single title by exact name (OMDb |
| get_by_imdb_idA | Look up a title by its IMDb ID (e.g. "tt0111161"). OMDb |
| get_episodeA | Look up a specific TV episode. Provide either |
| get_seasonA | List all episodes in a given season of a series. Provide either |
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 5 tools
Each tool targets a distinct operation: lookup by IMDb ID, by title, episode details, season listing, and free-text search. There is no overlap in functionality, and the descriptions clearly differentiate the use cases.
Most tools follow a 'get_X' pattern, but 'search_movies' uses 'search' instead of 'get', and 'get_by_imdb_id' and 'get_by_title' use 'get_by' rather than 'get'. This minor inconsistency does not hinder readability.
With 5 tools, the server covers the core OMDb operations—title lookup, ID lookup, season and episode retrieval, and text search—without unnecessary bloat. The count is well-scoped for a movie database API.
The tool surface covers the primary OMDb functionality (search, details by ID/title, season/episode). Missing are explicit tools for ratings or poster retrieval, but these are likely included in the results of existing tools, so gaps are minor.