{
  "markdown": "# TMDB MCP Server\n\n[![npm version](https://img.shields.io/npm/v/tmdb-mcp-server.svg)](https://www.npmjs.com/package/tmdb-mcp-server)\n[![npm downloads](https://img.shields.io/npm/dm/tmdb-mcp-server.svg)](https://www.npmjs.com/package/tmdb-mcp-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nA [Model Context Protocol (MCP)](https://modelcontextprotocol.io) server that provides access to [The Movie Database (TMDB)](https://www.themoviedb.org/) API. This server enables Claude and other MCP clients to search for movies, TV shows, and people, as well as get detailed information and recommendations.\n\n🌟 **Now available on the [Official MCP Registry](https://registry.modelcontextprotocol.io)**\n\n## Quick Start\n\nGet started in seconds with npm:\n\n```bash\n# Install globally\nnpm install -g tmdb-mcp-server\n\n# Or use with npx (no installation needed)\nnpx tmdb-mcp-server\n```\n\n**Get your free TMDB API token**: https://www.themoviedb.org/settings/api\n\n## Features\n\n### 🎬 Movie Tools\n- **search_movies** - Search for movies by title\n- **get_movie_details** - Get detailed information about a specific movie (budget, revenue, runtime, genres, etc.)\n- **discover_movies** - Discover movies with advanced filters (genre, language, year range, rating, sorting)\n- **get_recommendations** - Get movie recommendations based on a specific movie\n- **get_movie_credits** - Get cast and crew information for a movie\n\n### 📺 TV Show Tools\n- **search_tv_shows** - Search for TV shows by name\n- **get_tv_details** - Get detailed information about a specific TV show (seasons, episodes, networks, etc.)\n- **discover_tv_shows** - Discover TV shows with advanced filters (genre, language, year, rating, sorting)\n- **get_tv_recommendations** - Get TV show recommendations based on a specific show\n- **get_tv_credits** - Get cast and crew information for a TV show\n\n### 👥 People Tools\n- **search_people** - Search for actors, directors, and other entertainment industry professionals\n- **get_person_details** - Get detailed biographical information about a person\n\n### 🔥 Trending\n- **get_trending** - Get daily or weekly trending movies, TV shows, or people\n\n## Installation\n\n### Option 1: npm (Recommended)\n\nInstall from npm registry:\n\n```bash\nnpm install -g tmdb-mcp-server\n```\n\nThat's it! No build step required.\n\n### Option 2: From Source (For Development)\n\n**Prerequisites:**\n- Node.js (v18 or higher)\n- A TMDB API access token (get one free at [TMDB](https://www.themoviedb.org/settings/api))\n\n**Steps:**\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/tcehjaava/tmdb-mcp-server.git\ncd tmdb-mcp-server\n```\n\n2. Install dependencies:\n```bash\nnpm install\n```\n\n3. Create a `.env` file with your TMDB access token:\n```bash\ncp .env.example .env\n# Edit .env and add your TMDB_ACCESS_TOKEN\n```\n\n4. Build the server:\n```bash\nnpm run build\n```\n\n## Usage\n\n### With Claude Desktop\n\nAdd the server to your Claude Desktop configuration:\n\n**MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`\n**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`\n\n#### If installed via npm:\n\n```json\n{\n  \"mcpServers\": {\n    \"tmdb\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"tmdb-mcp-server\"],\n      \"env\": {\n        \"TMDB_ACCESS_TOKEN\": \"your_tmdb_access_token_here\"\n      }\n    }\n  }\n}\n```\n\n#### If installed from source:\n\n```json\n{\n  \"mcpServers\": {\n    \"tmdb\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/tmdb-mcp-server/build/index.js\"],\n      \"env\": {\n        \"TMDB_ACCESS_TOKEN\": \"your_tmdb_access_token_here\"\n      }\n    }\n  }\n}\n```\n\n### With Other MCP Clients\n\nThe server runs on stdio by default, making it compatible with any MCP client that supports stdio transport.\n\n### Remote Deployment (HTTP Mode)\n\nThe server also supports Streamable HTTP transport for remote deployment:\n\n```bash\nMCP_TRANSPORT=http PORT=3000 node build/index.js\n```\n\nSee [TRANSPORT.md](TRANSPORT.md) for detailed deployment instructions for platforms like Railway.\n\n## Development\n\n### Local Development\n\nRun the server in watch mode for development:\n```bash\nnpm run watch\n```\n\n### Debugging\n\nUse the MCP Inspector for debugging:\n```bash\nnpm run inspector\n```\n\nThe Inspector provides a web interface for testing and debugging MCP tools.\n\n### Code Formatting\n\nFormat code with Prettier:\n```bash\nnpm run format\n```\n\n## Example Queries\n\nHere are some example queries you can try with Claude:\n\n- \"Find Japanese sci-fi movies from 2020 onwards with a rating above 7\"\n- \"What are the top trending movies this week?\"\n- \"Get me recommendations based on The Matrix\"\n- \"Search for Christopher Nolan movies\"\n- \"Show me details about the TV show Breaking Bad\"\n- \"Find Korean dramas with high ratings\"\n\n## API Rate Limits\n\nTMDB API has rate limits on their free tier:\n- 50 requests per second\n- Consider implementing caching for production use\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request. For major changes, please open an issue first to discuss what you would like to change.\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgments\n\n- Built with the [Model Context Protocol SDK](https://github.com/modelcontextprotocol)\n- Data provided by [The Movie Database (TMDB)](https://www.themoviedb.org/)\n- This product uses the TMDB API but is not endorsed or certified by TMDB\n\n## Links\n\n- [MCP Documentation](https://modelcontextprotocol.io)\n- [TMDB API Documentation](https://developers.themoviedb.org/3)\n- [Claude Desktop](https://claude.ai/download)\n",
  "bytes": 5677,
  "sha": "2bec3759cbc6db082a07e1a0cbc6a9addea4e332e016cd144436728c3cc8eb69",
  "repo_slug": "tcehjaava/tmdb-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_tcehjaava_tmdb_mcp_server_c47049ac/readme"
}