Skip to main content
Glama
TMDB MCP Server

TMDB MCP Server

Where to watch

get_watch_providers
Read-only

Find streaming, rental, and purchase providers for a movie or TV show by country; returns provider names by access type or available regions when data is missing.

Instructions

Find where a movie or TV show can be streamed, rented or bought in a given country (JustWatch data via TMDB). Returns provider names per access type for that country; with no data there, returns available:false plus available_regions to retry with. Get the id from search_movies/search_tv.

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": {
      "media_type": "<media_type>",
      "id": "<id>"
    },
    "name": "get_watch_providers"
  }
}

Input Schema

NameRequiredDescriptionDefault
idYesTMDB id of the movie or TV show (as media_type says; from search_movies/search_tv).
regionNoThe user's country (pass it when known), whose streaming/rental/purchase providers to list.US
media_typeYesMedia type: 'movie' or 'tv'.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changedv0.15.0
    • changedInput schema / properties / id / description
      Previous value: -"TMDB numeric id."New value: +"TMDB id of the movie or TV show (as media_type says; from search_movies/search_tv)."
    • addedInput schema / properties / region / default
      Added value: +"US"
    • changedInput schema / properties / region / description
      Previous value: -"ISO-3166-1 country code for region-specific results (default 'US')."New value: +"The user's country (pass it when known), whose streaming/rental/purchase providers to list."
  2. Changed1 schema field changedv0.14.0
    • changedOutput schema / oneOf
      Previous value: -[
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "available": {
      -        "const": false,
      -        "type": "boolean"
      -      },
      -      "available_regions": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "region": {
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "region",
      -      "available",
      -      "available_regions"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": false,
      -    "properties": {
      -      "ads": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "available": {
      -        "const": true,
      -        "type": "boolean"
      -      },
      -      "available_regions": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "buy": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "free": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "link": {
      -        "anyOf": [
      -          {
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "region": {
      -        "type": "string"
      -      },
      -      "rent": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      },
      -      "streaming": {
      -        "items": {
      -          "type": "string"
      -        },
      -        "type": "array"
      -      }
      -    },
      -    "required": [
      -      "region",
      -      "available",
      -      "link",
      -      "streaming",
      -      "free",
      -      "ads",
      -      "rent",
      -      "buy",
      -      "available_regions"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "available": {
      +        "const": false,
      +        "type": "boolean"
      +      },
      +      "available_regions": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "region": {
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "region",
      +      "available",
      +      "available_regions"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": false,
      +    "properties": {
      +      "ads": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "available": {
      +        "const": true,
      +        "type": "boolean"
      +      },
      +      "available_regions": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "buy": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "free": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "link": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      },
      +      "region": {
      +        "type": "string"
      +      },
      +      "rent": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      },
      +      "streaming": {
      +        "items": {
      +          "type": "string"
      +        },
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "region",
      +      "available",
      +      "link",
      +      "streaming",
      +      "free",
      +      "ads",
      +      "rent",
      +      "buy",
      +      "available_regions"
      +    ],
      +    "type": "object"
      +  }
      +]
  3. Changed1 schema field changedv0.10.1
    • changedInput schema / properties / media_type / description
      Previous value: -"Whether the id refers to a movie or a TV show."New value: +"Media type: 'movie' or 'tv'."
  4. Addedv0.8.1
  5. Removedv0.8.1
  6. Changed3 schema fields changedv0.8.0
    • changedInput schema / $schema
      Previous value: -"http://json-schema.org/draft-07/schema#"New value: +"https://json-schema.org/draft/2020-12/schema"
    • addedInput schema / additionalProperties
      Added value: +false
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "$schema": "https://json-schema.org/draft/2020-12/schema",
      +  "oneOf": [
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "available": {
      +          "const": false,
      +          "type": "boolean"
      +        },
      +        "available_regions": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "region": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "region",
      +        "available",
      +        "available_regions"
      +      ],
      +      "type": "object"
      +    },
      +    {
      +      "additionalProperties": false,
      +      "properties": {
      +        "ads": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "available": {
      +          "const": true,
      +          "type": "boolean"
      +        },
      +        "available_regions": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "buy": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "free": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "link": {
      +          "anyOf": [
      +            {
      +              "type": "string"
      +            },
      +            {
      +              "type": "null"
      +            }
      +          ]
      +        },
      +        "region": {
      +          "type": "string"
      +        },
      +        "rent": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        },
      +        "streaming": {
      +          "items": {
      +            "type": "string"
      +          },
      +          "type": "array"
      +        }
      +      },
      +      "required": [
      +        "region",
      +        "available",
      +        "link",
      +        "streaming",
      +        "free",
      +        "ads",
      +        "rent",
      +        "buy",
      +        "available_regions"
      +      ],
      +      "type": "object"
      +    }
      +  ],
      +  "type": "object"
      +}
  7. First observedv0.3.0

TDQS

A4.2/5.0
Behavior4/5

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

Beyond the readOnlyHint/openWorldHint annotations, it discloses the data source (JustWatch via TMDB), the response shape (provider names grouped per access type) and a specific failure mode with a recovery field (available:false plus available_regions). That is real behavioral detail an agent cannot get from the annotations, though rate limits or caching behavior are not mentioned.

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 compact sentences: capability and data source first, return and fallback behavior second, prerequisite id sourcing last. Every sentence carries information and nothing is redundant with the schema.

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 three-parameter read tool with a declared output schema, the description covers the prerequisite (id sourcing), region semantics, and the empty-region fallback. There is no meaningful gap left for an agent to guess at before invoking it.

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%, so the baseline is 3, but the description adds meaning the schema does not: the id must be a TMDB id obtained from search_movies/search_tv and must match media_type, and region should be the user's country rather than a default. That sourcing guidance is exactly the kind of semantics the schema cannot express.

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?

The description uses a concrete verb and resource ('Find where a movie or TV show can be streamed, rented or bought in a given country') plus the data source, so the purpose is unambiguous. It does not explicitly contrast with the sibling search_watch_providers, so an agent must infer that this tool takes a known TMDB id while the sibling presumably searches by title.

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?

It gives concrete usage context: supply the user's country when known (region defaults to US) and how to recover when the region has no data by retrying with available_regions. It never states when not to use it or names an alternative for title-based lookups, so the routing guidance is clear but not exhaustive.

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