TMDB MCP Server for accessing The Movie Database API
Single tool with basic schema and description. Tool name 'search_movies' follows verb_noun convention (+). Description is present but minimal (47 chars, below 50-200 char baseline for LLM optimization). Input schema is properly typed with required/optional params, but lacks critical details: no enum constraints, no format specifications, no output schema documented, no error recovery guidance. Parameters lack depth, 'query' description is generic, 'year' and 'page' descriptions are terse. No documentation of pagination behavior, result limits, or what fields the response contains. Error handling returns raw API errors without actionable recovery steps. Missing: output schema, per-parameter validation rules, result limits, chaining IDs for downstream tools.
Search for movies using The Movie Database API
No output schema documented. LLM cannot predict response structure, fields, or data types. Downstream tool chaining impossible without trial-and-error.
Tool description is 47 characters, below the 50-200 char baseline for LLM optimization. Lacks WHEN to use, WHAT it returns, and prerequisites. Does not explain pagination or result limits.
No result limit or pagination guidance in description. API may return hundreds of results; LLM has no signal to paginate or cap results, risking context window exhaustion.
Error handling returns raw TMDB API errors without recovery guidance. 'TMDB API error: ...' tells LLM nothing actionable. Should classify as retryable/user-fixable and suggest next steps.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 45 | 2026-07-28+ | v2 |
Parameter descriptions lack format/constraint details. 'year' accepts any number, should specify valid range (e.g. 1800-2100). 'page' defaults to 1 but no max specified. LLM may pass invalid values.