{"_id":"@dennisk2025/random-movie-suggestion-omdb","name":"@dennisk2025/random-movie-suggestion-omdb","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@dennisk2025/random-movie-suggestion-omdb","version":"1.0.0","description":"Suggests a random movie with title, release year, genre, short plot, and poster image using the OMDb API's public random functionality.","type":"module","main":"index.js","bin":{"random-movie-suggestion-omdb":"index.js"},"dependencies":{"@modelcontextprotocol/sdk":"latest","axios":"latest"},"author":{"name":"dennisk2025"},"license":"MIT","_id":"@dennisk2025/random-movie-suggestion-omdb@1.0.0","_nodeVersion":"22.20.0","_npmVersion":"10.9.3","dist":{"integrity":"sha512-5XvDnGrabXCyrm6MIIm8AjA6Iad1k8dcV6pPDllnrkSp/iL783OX15UkCOALtPbfN8BxmqmZDtMQRDRiutD5qw==","shasum":"5d3ae3d4b360c4f8fe72efd571b1a2deafed8399","tarball":"https://registry.npmjs.org/@dennisk2025/random-movie-suggestion-omdb/-/random-movie-suggestion-omdb-1.0.0.tgz","fileCount":3,"unpackedSize":7502,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCUxsjlWkxg1dj9Th1cMwVExt3I5vghLHBu0vhSH2PwmwIhAIan2IGXlwECR9MTHXqaiXfWXUBcZYggYVv3ov/vr/gF"}]},"_npmUser":{"name":"dennisk2025","email":"4dennisk@gmail.com"},"directories":{},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/random-movie-suggestion-omdb_1.0.0_1761426986376_0.07800604208739803"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-25T21:16:26.204Z","1.0.0":"2025-10-25T21:16:26.574Z","modified":"2025-10-25T21:16:27.025Z"},"maintainers":[{"name":"dennisk2025","email":"4dennisk@gmail.com"}],"description":"Suggests a random movie with title, release year, genre, short plot, and poster image using the OMDb API's public random functionality.","author":{"name":"dennisk2025"},"license":"MIT","readme":"# random-movie-suggestion-omdb\n\nSuggests 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.\n\n---\n\n## Installation\n\nYou can run this MCP server directly with npx (recommended):\n\n```\nnpx @dennisk2025/random-movie-suggestion-omdb\n```\n\nOr install globally:\n\n```\nnpm install -g @dennisk2025/random-movie-suggestion-omdb\nrandom-movie-suggestion-omdb\n```\n\n---\n\n## Adding to Claude Desktop\n\nAdd the following to your Claude Desktop config file at:\n- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n- **Windows**: `%APPDATA%\\Claude\\claude_desktop_config.json`\n\n```json\n{\n  \"mcpServers\": {\n    \"movie-suggestor\": {\n      \"command\": \"npx\",\n      \"args\": [\"@dennisk2025/random-movie-suggestion-omdb\"]\n    }\n  }\n}\n```\n\nYou can replace \"movie-suggestor\" with any short identifier you prefer.\n\n---\n\n## Usage\n\nAfter adding the server to Claude Desktop or running it manually, you can use the following tool:\n\n### Tool: get_random_movie_suggestion\n\n**Description:**\nFetches and returns a random movie's title, release year, genre, short plot, and poster image. Useful for movie night ideas or exploring new films.\n\n**Parameters:**\n- *(none)*\n\n**Example Tool Call:**\n\n```\n{\n  \"name\": \"get_random_movie_suggestion\",\n  \"arguments\": {}\n}\n```\n\n**Example Response:**\n\n```\n{\n  \"title\": \"The Matrix\",\n  \"year\": \"1999\",\n  \"genre\": \"Action, Sci-Fi\",\n  \"plot\": \"A computer hacker learns about the true nature of his reality and his role in the war against its controllers.\",\n  \"poster\": \"https://m.media-amazon.com/images/M/MV5...jpg\"\n}\n```\n\n---\n\n## Available Tools\n\n| Tool Name                      | Description                                                                                         | Parameters |\n|------------------------------- |-----------------------------------------------------------------------------------------------------|------------|\n| get_random_movie_suggestion    | Fetches a random movie's title, release year, genre, short plot, and poster image.                  | *(none)*   |\n\n---\n\n## Notes & Limitations\n- 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.\n- This MCP only returns movies (not TV series or other types).\n- For best results, use from Claude Desktop or with up-to-date `@modelcontextprotocol/sdk`.\n","readmeFilename":"README.md","_rev":"1-b4764beef977441967d8c2d64cfebc6e"}