Skip to main content
Glama
TMDB MCP Server

TMDB MCP Server

Get trending titles

get_trending
Read-only

Retrieve what's trending on TMDB for movies, TV shows, people, or all, filtered by day or week. Use it to find what's popular right now and route each result by its media_type.

Instructions

Get what's trending on TMDB. media_type selects movies, TV, people, or all; time_window is the trending period (today vs this week). Good for 'what's popular right now'. Each result row carries its own media_type ('movie' | 'tv' | 'person'); check it to route to the right get_* tool, especially when media_type is left at 'all'.

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "get_trending"
  }
}

Input Schema

NameRequiredDescriptionDefault
pageNo1-based page number for pagination (TMDB returns up to 20 results per page, max 500). Adult/softcore titles are dropped from this list, so a page can come back shorter, even empty, while total_pages/total_results stay TMDB's own; keep paging up to total_pages.
media_typeNoWhich kind of entity to rank.all
time_windowNoTrending period: 'day' or 'week'.week

Output Schema

NameRequiredDescriptionDefault
pageYes
resultsYes
total_pagesYes
total_resultsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed5 schema fields changedv0.15.0
    • addedInput schema / properties / media_type / default
      Added value: +"all"
    • changedInput schema / properties / media_type / description
      Previous value: -"Which kind of entity to rank. Defaults to 'all'."New value: +"Which kind of entity to rank."
    • changedInput schema / properties / page / description
      Previous value: -"1-based page number for pagination (TMDB returns up to 20 results per page, max 500)."New value: +"1-based page number for pagination (TMDB returns up to 20 results per page, max 500). Adult/softcore titles are dropped from this list, so a page can come back shorter, even empty, while total_pages/total_results stay TMDB's own; keep paging up to total_pages."
    • addedInput schema / properties / time_window / default
      Added value: +"week"
    • changedInput schema / properties / time_window / description
      Previous value: -"Trending period: 'day' or 'week'. Defaults to 'week'."New value: +"Trending period: 'day' or 'week'."
  2. Changed1 schema field changedv0.14.0
    • changedOutput schema / properties / results / items / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "id": {
      -        "type": "number"
      -      },
      -      "media_type": {
      -        "const": "movie",
      -        "type": "string"
      -      },
      -      "original_title": {
      -        "type": "string"
      -      },
      -      "overview": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "poster_url": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "release_date": {
      -        "anyOf": [
      -          {
      -            "format": "date",
      -            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null
      -      },
      -      "title": {
      -        "type": "string"
      -      },
      -      "vote_average": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "vote_count": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "year": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "media_type",
      -      "year",
      -      "release_date",
      -      "vote_average",
      -      "vote_count",
      -      "overview",
      -      "poster_url"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "first_air_date": {
      -        "anyOf": [
      -          {
      -            "format": "date",
      -            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ],
      -        "default": null
      -      },
      -      "id": {
      -        "type": "number"
      -      },
      -      "media_type": {
      -        "const": "tv",
      -        "type": "string"
      -      },
      -      "name": {
      -        "type": "string"
      -      },
      -      "original_name": {
      -        "type": "string"
      -      },
      -      "overview": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "poster_url": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "vote_average": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "vote_count": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "year": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "media_type",
      -      "year",
      -      "first_air_date",
      -      "vote_average",
      -      "vote_count",
      -      "overview",
      -      "poster_url"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "id": {
      -        "type": "number"
      -      },
      -      "known_for": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "known_for_department": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "media_type": {
      -        "const": "person",
      -        "type": "string"
      -      },
      -      "name": {
      -        "type": "string"
      -      },
      -      "popularity": {
      -        "anyOf": [
      -          {
      -            "type": "number"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "profile_url": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      }
      -    },
      -    "required": [
      -      "id",
      -      "media_type",
      -      "known_for_department",
      -      "popularity",
      -      "profile_url",
      -      "known_for"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "id": {
      +        "type": "number"
      +      },
      +      "media_type": {
      +        "const": "movie",
      +        "type": "string"
      +      },
      +      "original_title": {
      +        "type": "string"
      +      },
      +      "overview": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "poster_url": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "release_date": {
      +        "anyOf": [
      +          {
      +            "format": "date",
      +            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null
      +      },
      +      "title": {
      +        "type": "string"
      +      },
      +      "vote_average": {
      +        "description": "TMDB's own 0-10 user score. A different audience and scale from the IMDb/RT/Metacritic scores get_movie/get_tv return as `ratings` — don't compare, average or substitute across the two.",
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "vote_count": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "year": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "media_type",
      +      "year",
      +      "release_date",
      +      "vote_average",
      +      "vote_count",
      +      "overview",
      +      "poster_url"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "first_air_date": {
      +        "anyOf": [
      +          {
      +            "format": "date",
      +            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ],
      +        "default": null
      +      },
      +      "id": {
      +        "type": "number"
      +      },
      +      "media_type": {
      +        "const": "tv",
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "original_name": {
      +        "type": "string"
      +      },
      +      "overview": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "poster_url": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "vote_average": {
      +        "description": "TMDB's own 0-10 user score. A different audience and scale from the IMDb/RT/Metacritic scores get_movie/get_tv return as `ratings` — don't compare, average or substitute across the two.",
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "vote_count": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "year": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "media_type",
      +      "year",
      +      "first_air_date",
      +      "vote_average",
      +      "vote_count",
      +      "overview",
      +      "poster_url"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "id": {
      +        "type": "number"
      +      },
      +      "known_for": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "known_for_department": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "media_type": {
      +        "const": "person",
      +        "type": "string"
      +      },
      +      "name": {
      +        "type": "string"
      +      },
      +      "popularity": {
      +        "type": [
      +          "number",
      +          "null"
      +        ]
      +      },
      +      "profile_url": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "id",
      +      "media_type",
      +      "known_for_department",
      +      "popularity",
      +      "profile_url",
      +      "known_for"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Addedv0.10.1
  4. Removedv0.8.0
  5. First observedv0.3.0

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=true and openWorldHint=true, so safety is covered. The description adds the mixed-entity result behavior and a routing hint, but says nothing about freshness of windows, filtering of results, or pagination behavior (that caveat lives only in the schema).

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three tight sentences, front-loaded with the purpose, then the parameter gloss, then the actionable routing advice. No filler, and no sentence duplicates structured fields verbatim.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Complete enough: parameters are fully documented in the schema, an output schema exists, and the description supplies the use case plus the cross-tool routing step. Only minor omissions such as freshness or result filtering keep it from a 5.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline applies; the description only glosses media_type's four options and maps time_window to 'today vs this week'. It adds marginal meaning beyond the enum descriptions without fully restating them, which is fine but not value-adding.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Get what's trending on TMDB') and names the scoping parameters, so the agent can tell this is a trending feed rather than a search or discover endpoint. It does not name an explicit sibling alternative, so it stops just short of a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives a concrete use case ('Good for what's popular right now') and post-call guidance: inspect each row's media_type and route to the right get_* tool, especially with media_type='all'. It lacks explicit when-not-to-use guidance versus discover_movies, discover_tv, or search_multi.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.