random-movie-suggestion-omdb

Suggests a random movie with title, release year, genre, short plot, and poster image using the OMDb API's public search functionality. Useful for movie night ideas and movie exploration.

Installation

You can run this MCP server directly with npx (recommended):

npx @dennisk2025/random-movie-suggestion-omdb

Or install globally:

npm install -g @dennisk2025/random-movie-suggestion-omdb
random-movie-suggestion-omdb

Adding to Claude Desktop

Add the following to your Claude Desktop config file at:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "movie-suggestor": {
      "command": "npx",
      "args": ["@dennisk2025/random-movie-suggestion-omdb"]
    }
  }
}

You can replace "movie-suggestor" with any short identifier you prefer.

Usage

After adding the server to Claude Desktop or running it manually, you can use the following tool:

Tool: get_random_movie_suggestion

Description: Fetches and returns a random movie's title, release year, genre, short plot, and poster image. Useful for movie night ideas or exploring new films.

Parameters:

• (none)

Example Tool Call:

{
  "name": "get_random_movie_suggestion",
  "arguments": {}
}

Example Response:

{
  "title": "The Matrix",
  "year": "1999",
  "genre": "Action, Sci-Fi",
  "plot": "A computer hacker learns about the true nature of his reality and his role in the war against its controllers.",
  "poster": "https://m.media-amazon.com/images/M/MV5...jpg"
}

Available Tools

| Tool Name | Description | Parameters | |------------------------------- |-----------------------------------------------------------------------------------------------------|------------| | get_random_movie_suggestion | Fetches a random movie's title, release year, genre, short plot, and poster image. | (none) |

Notes & Limitations

• The OMDb API now requires an API key and their public demo key may have strict rate limits or temporary outages. If fetching fails, please try again later.
• This MCP only returns movies (not TV series or other types).
• For best results, use from Claude Desktop or with up-to-date @modelcontextprotocol/sdk.