Potencia tu agente
El comando propio del publicador. No es un endpoint de PlugMCP.
Host a copy with our keys and logs.
npx -y @cyanheads/[email protected]Claude Code no tiene enlace de instalación para un comando local. Copia el comando de abajo y ejecútalo en una terminal.
TMDB_API_KEY=<secret> TMDB_LANGUAGE=<value> TMDB_DEFAULT_REGION=<value> MCP_LOG_LEVEL=<value> claude mcp add io.github.cyanheads-tmdb-mcp-server -- npx -y @cyanheads/tmdb-mcp-server@0.2.0Ejecútalo en una terminal.
{ "mcpServers": { "io.github.cyanheads-tmdb-mcp-server": { "command": "npx", "args": [ "-y", "@cyanheads/[email protected]" ], "env": { "TMDB_API_KEY": "<secret>", "TMDB_LANGUAGE": "<value>", "TMDB_DEFAULT_REGION": "<value>", "MCP_LOG_LEVEL": "<value>" } } }}claude_desktop_config.json
¿URL remota o un comando en tu máquina? En qué se diferencian las dos instalaciones
Ejecutar en PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
AbrirMovie and TV metadata powered by The Movie Database (TMDB). Search titles and people by name, pull full credits and filmographies, discover titles by filtered criteria, track trending content, and check where to stream in your region.
tmdb_search_titles toolmulti mode (default) mixes movies, shows, and people, tagged with media_type; movie, tv, or person restrict to one typeyear (movie/tv modes), language, include_adult, and page; empty results return normally with recovery guidanceid, media_type, title/name, release_year, overview, vote_average, genre_names, and a poster or profile URLtmdb_get_movie toolappend array (e.g. ["credits"]) to shrink the payloadtmdb_get_watch_providerstmdb_get_show toolappend options as tmdb_get_movie, with content_ratings (US TV rating) in place of release_datesseason_number from seasons[] to tmdb_get_season for episodestmdb_get_season toolseries_id is echoed from the input; season 0 is "Specials"tmdb_get_person toolcombined_credits split into cast_credits and crew_credits, newest first; credits_page (default 1) returns up to 50 of each, with full totals on every pagenext_credits_page for more; pages past the end return empty liststmdb_discover_titles toolwith_genres/without_genres, year or a release_date_gte/lte window, vote_average range, vote_count_gte, with_cast/with_crew (movie), with_networks (tv), with_watch_providers + watch_region, with_original_language, and runtime rangevote_average.desc with vote_count_gte (~100–1000) to keep low-vote titles out of the topwith_watch_providers without watch_region returns region_requiredtmdb_get_trending toolmedia_type: all (default) mixes movies, shows, and people; or restrict to one typetime_window: day or week (default)page for more; empty results return normally with recovery guidancetmdb_get_watch_providers toollinkwatch_region (ISO 3166-1 alpha-2) is required; the response always states the regionwith_watch_providers in tmdb_discover_titlestmdb://movie/{movie_id} resourcetmdb_get_movie — application/jsonmovie_id comes from tmdb_search_titles or tmdb_discover_titlesmovie_not_found error when TMDB returns 404 for the idtmdb://tv/{series_id} resourcetmdb_get_show — application/jsonseries_id comes from tmdb_search_titles or tmdb_discover_titlesshow_not_found error when TMDB returns 404 for the idtmdb://person/{person_id} resourceapplication/json; use tmdb_get_person for further pagesperson_id comes from tmdb_search_titles (mode "person")person_not_found error when TMDB returns 404 for the idBuilt on @cyanheads/mcp-ts-core: stdio and Streamable HTTP transports, pluggable auth (none / jwt / oauth), swappable storage (in-memory, filesystem, Supabase, Cloudflare KV/R2/D1), structured logging with optional OpenTelemetry tracing.
TMDB-specific:
Agent-friendly output:
enrichment.attributionA TMDB API Read Access Token is required. Create a free TMDB account, then copy the API Read Access Token (a v4 JWT) from your API settings — this server authenticates v3 endpoints with Authorization: Bearer <token>, not the legacy ?api_key= query parameter.
Add the following to your MCP client configuration file.
{
"mcpServers": {
"tmdb-mcp-server": {
"type": "stdio",
"command": "bunx",
"args": ["@cyanheads/tmdb-mcp-server@latest"],
"env": {
"MCP_TRANSPORT_TYPE": "stdio",
"MCP_LOG_LEVEL": "info",
"TMDB_API_KEY": "your-tmdb-read-access-token"
}
}
}
}
Or with npx (no Bun required):
{
"mcpServers": {
"tmdb-mcp-server": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@cyanheads/tmdb-mcp-server@latest"],
"env": {
"MCP_TRANSPORT_TYPE": "stdio",
"MCP_LOG_LEVEL": "info",
"TMDB_API_KEY": "your-tmdb-read-access-token"
}
}
}
}
Or with Docker:
{
"mcpServers": {
"tmdb-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run", "-i", "--rm",
"-e", "MCP_TRANSPORT_TYPE=stdio",
"-e", "TMDB_API_KEY=your-tmdb-read-access-token",
"ghcr.io/cyanheads/tmdb-mcp-server:latest"
]
}
}
}
For Streamable HTTP, set the transport and start the server:
MCP_TRANSPORT_TYPE=http MCP_HTTP_PORT=3010 TMDB_API_KEY=... bun run start:http
# Server listens at http://localhost:3010/mcp
git clone https://github.com/cyanheads/tmdb-mcp-server.git
cd tmdb-mcp-server
bun install
cp .env.example .env
# edit .env and set TMDB_API_KEY
All configuration is validated at startup via Zod schemas. Key environment variables:
See .env.example for the full list of optional overrides.
Build and run:
# One-time build
bun run rebuild
# Run the built server
bun run start:stdio
# or
bun run start:http
Run checks and tests:
bun run devcheck # Lint, format, typecheck, security
bun run test # Vitest test suite
bun run lint:mcp # Validate MCP definitions against spec
docker build -t tmdb-mcp-server .
docker run --rm -e TMDB_API_KEY=your-token -p 3010:3010 tmdb-mcp-server
The Dockerfile defaults to HTTP transport, stateless session mode, and logs to /var/log/tmdb-mcp-server. OpenTelemetry peer dependencies are installed by default — build with --build-arg OTEL_ENABLED=false to omit them.
See AGENTS.md (or CLAUDE.md, the same content) for development guidelines and architectural rules. The short version:
try/catch in tool logicctx.log for request-scoped logging, ctx.state for tenant-scoped storagesrc/mcp-server/*/definitions/index.tsThis product uses the TMDB API but is not endorsed or certified by TMDB. Streaming availability data is provided by JustWatch via TMDB and is region-specific.
Issues are welcome. Run checks and tests before submitting:
bun run devcheck
bun run test
Apache-2.0 — see LICENSE for details.
Search, detail, and discovery for movies, TV, and people on The Movie Database (TMDB).
{ "mcpServers": { "io.github.cyanheads-tmdb-mcp-server": { "command": "npx", "args": [ "-y", "@cyanheads/[email protected]" ], "env": { "TMDB_API_KEY": "<secret>", "TMDB_LANGUAGE": "<value>", "TMDB_DEFAULT_REGION": "<value>", "MCP_LOG_LEVEL": "<value>" } } }}Herramientas
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
El publicador indica estas variables de entorno: TMDB_API_KEY, TMDB_LANGUAGE, TMDB_DEFAULT_REGION, MCP_LOG_LEVEL, MCP_HTTP_HOST, MCP_HTTP_PORT, MCP_HTTP_ENDPOINT_PATH, MCP_AUTH_MODE, MCP_TRANSPORT_TYPE.
Tmdb se ejecuta localmente por stdio.
Última comprobación: 2026-11-09. Search, detail, and discovery for movies, TV, and people on The Movie Database (TMDB).