Skip to main content
Glama
TMDB MCP Server

TMDB MCP Server

Find by IMDb id

find_by_imdb_id
Read-only

Converts an IMDb title or name ID into matching TMDB movie, TV, person, or episode results so you can use the correct TMDB ID with other lookup tools.

Instructions

Resolve an IMDb id (e.g. 'tt0133093') to TMDB entities: returns matching movie, TV, person and TV-episode results. Use when you only have an IMDb id and need the TMDB id for the other tools. IMDb also gives individual episodes 'tt' ids (e.g. Breaking Bad's pilot 'tt0959621'); those land in tv_episode_results as show_id + season_number + episode_number, ready for get_tv_episode. An unknown id comes back with every list empty.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "imdb_id": "<imdb_id>"
    },
    "name": "find_by_imdb_id"
  }
}

Input Schema

NameRequiredDescriptionDefault
imdb_idYesIMDb title (tt…) or name (nm…) id.

Output Schema

NameRequiredDescriptionDefault
tv_resultsYes
movie_resultsYes
person_resultsYes
tv_episode_resultsYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changedv0.15.0
    • addedOutput schema / properties / tv_episode_results
      Added value: +{
      +  "items": {
      +    "additionalProperties": false,
      +    "properties": {
      +      "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
      +      },
      +      "episode_number": {
      +        "type": "number"
      +      },
      +      "name": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "season_number": {
      +        "type": "number"
      +      },
      +      "show_id": {
      +        "type": "number"
      +      }
      +    },
      +    "required": [
      +      "season_number",
      +      "episode_number",
      +      "name",
      +      "air_date",
      +      "show_id"
      +    ],
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "movie_results",
      -  "tv_results",
      -  "person_results"
      -]New value: +[
      +  "movie_results",
      +  "tv_results",
      +  "person_results",
      +  "tv_episode_results"
      +]
  2. Changed29 schema fields changedv0.14.0
    • removedOutput schema / properties / movie_results / items / properties / overview / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / movie_results / items / properties / overview / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / movie_results / items / properties / poster_url / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / movie_results / items / properties / poster_url / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / movie_results / items / properties / vote_average / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / movie_results / items / properties / vote_average / description
      Added value: +"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."
    • addedOutput schema / properties / movie_results / items / properties / vote_average / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / movie_results / items / properties / vote_count / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / movie_results / items / properties / vote_count / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / movie_results / items / properties / year / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / movie_results / items / properties / year / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • addedOutput schema / properties / person_results / items / properties / known_for
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • removedOutput schema / properties / person_results / items / properties / known_for_department / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / person_results / items / properties / known_for_department / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • addedOutput schema / properties / person_results / items / properties / popularity
      Added value: +{
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • removedOutput schema / properties / person_results / items / properties / profile_url / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / person_results / items / properties / profile_url / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • changedOutput schema / properties / person_results / items / required
      Previous value: -[
      -  "id",
      -  "media_type",
      -  "known_for_department",
      -  "profile_url"
      -]New value: +[
      +  "id",
      +  "media_type",
      +  "known_for_department",
      +  "popularity",
      +  "profile_url",
      +  "known_for"
      +]
    • removedOutput schema / properties / tv_results / items / properties / overview / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / tv_results / items / properties / overview / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / tv_results / items / properties / poster_url / anyOf
      Removed value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / tv_results / items / properties / poster_url / type
      Added value: +[
      +  "string",
      +  "null"
      +]
    • removedOutput schema / properties / tv_results / items / properties / vote_average / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / tv_results / items / properties / vote_average / description
      Added value: +"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."
    • addedOutput schema / properties / tv_results / items / properties / vote_average / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / tv_results / items / properties / vote_count / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / tv_results / items / properties / vote_count / type
      Added value: +[
      +  "number",
      +  "null"
      +]
    • removedOutput schema / properties / tv_results / items / properties / year / anyOf
      Removed value: -[
      -  {
      -    "type": "number"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]
    • addedOutput schema / properties / tv_results / items / properties / year / type
      Added value: +[
      +  "number",
      +  "null"
      +]
  3. Changed4 schema fields changedv0.10.1
    • changedOutput schema / properties / movie_results / items / properties / release_date / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "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"
      +  }
      +]
    • addedOutput schema / properties / movie_results / items / properties / release_date / default
      Added value: +null
    • changedOutput schema / properties / tv_results / items / properties / first_air_date / anyOf
      Previous value: -[
      -  {
      -    "type": "string"
      -  },
      -  {
      -    "type": "null"
      -  }
      -]New value: +[
      +  {
      +    "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"
      +  }
      +]
    • addedOutput schema / properties / tv_results / items / properties / first_air_date / default
      Added value: +null
  4. Addedv0.8.1
  5. Removedv0.8.0
  6. First observedv0.3.0

TDQS

A4.4/5.0
Behavior4/5

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

Annotations already cover safety (readOnlyHint, openWorldHint), and the description adds real behavior beyond them: episode 'tt' ids come back as show_id + season_number + episode_number, and an unknown id yields empty lists rather than an error. The return-shape detail overlaps somewhat with the existing output schema, which keeps it from a 5.

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

Conciseness4/5

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

Front-loaded with the core verb and return set, then progressively adds the episode edge case and the empty-result behavior. Dense but every sentence carries information; only the episode-mapping sentence is slightly long-winded.

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

Completeness5/5

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

For a one-parameter lookup with full schema coverage, annotations, and an output schema, the description covers purpose, selection condition, id formats, episode mapping, and the not-found case. Nothing an agent needs to call it correctly is missing.

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

Parameters4/5

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

Schema coverage is 100% and the schema already documents the tt/nm pattern, so the baseline is 3. The description goes further by giving concrete examples ('tt0133093', 'tt0959621') and clarifying that nm ids (people) are also valid inputs, which the schema regex hints at but does not explain.

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

Purpose5/5

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

States a specific verb+resource ('Resolve an IMDb id ... to TMDB entities') and enumerates the entity types returned (movie, TV, person, TV-episode). It is clearly distinguishable from the search_* and get_* siblings, which take TMDB ids or names rather than IMDb ids.

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 clear selection condition: use when you only have an IMDb id and need the TMDB id for the other tools. It also routes follow-on work to get_tv_episode for episode hits. It never names the alternative to pick when you do have a title/TMDB id (e.g. search_multi), so the when-not side is implied rather than stated.

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