TVmaze shows, people, next episodes in your timezone, episode guides, schedules, and credits.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
List the credited cast of a show with the characters they play, optionally with crew; or list the guest cast of one episode, optionally with its guest crew such as the director and writers. Results are paged: cast rows come first, then crew rows, and each page splits them back into cast and crew. The source records no recurring-versus-guest distinction on a show’s cast list, so a name’s absence from it does not mean the performer never appeared — check an episode’s guest cast for that.
This tool takes no arguments.
List the credited cast of a show with the characters they play, optionally with crew; or list the guest cast of one episode, optionally with its guest crew such as the director and writers. Results are paged: cast rows come first, then crew rows, and each page splits them back into cast and crew. The source records no recurring-versus-guest distinction on a show’s cast list, so a name’s absence from it does not mean the performer never appeared — check an episode’s guest cast for that.
No arguments.
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"scope",
"show_id"
],
"properties": {
"name": {
"type": "string",
"description": "Case-insensitive substring in performer, character, or crew role. Blank means no filter; crew is searched only with include_crew."
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Maximum credits to return in this call, cast and crew together. Requests above 250 are clamped to 250. Applies to every page, including a call that passes cursor. A long-running series carries over a thousand cast credits."
},
"scope": {
"type": "string",
"const": "show",
"description": "List the show’s main cast."
},
"cursor": {
"type": "string",
"description": "Continuation token from a previous call’s next_cursor. It carries only the position to resume from; the page size comes from limit. Omit for the first page."
},
"show_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "TVmaze show id, from tvmaze_search_shows, tvmaze_lookup_show, or tvmaze_get_schedule.",
"exclusiveMinimum": 0
},
"include_crew": {
"type": "boolean",
"default": false,
"description": "Also list the show’s crew credits — producers, creators, and other series-level roles, with no episode attribution. Off by default; a long-running series carries hundreds and they are rarely what a cast question is asking for."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"scope",
"episode_id"
],
"properties": {
"name": {
"type": "string",
"description": "Case-insensitive substring in performer, character, or crew role. Blank means no filter; crew is searched only with include_crew."
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Maximum credits to return in this call, cast and crew together. Requests above 250 are clamped to 250. Applies to every page, including a call that passes cursor. A long-running series carries over a thousand cast credits."
},
"scope": {
"type": "string",
"const": "episode",
"description": "List one episode’s guest cast."
},
"cursor": {
"type": "string",
"description": "Continuation token from a previous call’s next_cursor. It carries only the position to resume from; the page size comes from limit. Omit for the first page."
},
"episode_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "TVmaze episode id, from tvmaze_get_episodes, tvmaze_get_next_episode, tvmaze_get_schedule, or tvmaze_get_show.",
"exclusiveMinimum": 0
},
"include_crew": {
"type": "boolean",
"default": false,
"description": "Also list the episode’s guest crew — who directed and wrote it, as TVmaze credits them. Off by default."
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}List a show’s episodes with air times, runtimes, and synopses. Pass a season number to list one season, which is the cheaper path and the usual one; pass air_date to list the episodes dated to one day, the direct path to a single night of a daily show; omit both to walk the whole run, which is paged because a long-running series returns hundreds of episodes. Specials are excluded unless include_specials is set, and the number left out is reported.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Maximum episodes to return in this call. Requests above 250 are clamped to 250. Applies to every page, including a call that passes cursor. Raise it for a short series; the default keeps a long run inside a reasonable response size. |
| cursor | string | Continuation token from a previous call’s next_cursor. It carries only the position to resume from; the page size comes from limit. Omit for the first page. |
| season | integer | Season number to list, as numbered in the season list from tvmaze_get_show. Omit, together with air_date, to list every episode of the series. Daily shows number seasons by calendar year. |
| show_id* | integer | TVmaze show id, from tvmaze_search_shows, tvmaze_lookup_show, or tvmaze_get_schedule. |
| air_date | string | Date to list, ISO 8601 (YYYY-MM-DD): the episodes the source dates to that day. It matches the source’s airdate, the broadcaster’s own programming day, so on a late-night slot it can differ by a day from the local_date an episode reports. Cannot be combined with season. |
Report when a show’s next episode airs, converted to a viewer timezone. Accepts a TVmaze id or a show title — a title is resolved with a stricter single-match search than tvmaze_search_shows uses. A show with no scheduled next episode is reported as a miss carrying its most recent episode, which is the normal state for a series between seasons.
No arguments.
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"by",
"show_id"
],
"properties": {
"by": {
"type": "string",
"const": "id",
"description": "Identify the show by its TVmaze id."
},
"show_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "TVmaze show id, from tvmaze_search_shows, tvmaze_lookup_show, or tvmaze_get_schedule.",
"exclusiveMinimum": 0
},
"timezone": {
"type": "string",
"pattern": "^[A-Za-z0-9_+-]+(\\/[A-Za-z0-9_+-]+){0,2}$",
"description": "IANA timezone name for the air time, e.g. \"America/Los_Angeles\". Defaults to the server-configured timezone."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"by",
"title"
],
"properties": {
"by": {
"type": "string",
"const": "title",
"description": "Identify the show by title. Resolved to a single best match."
},
"title": {
"type": "string",
"minLength": 1,
"description": "Show title. Matched to one best result; when several shows share a title, resolve the id with tvmaze_search_shows first and call again with by \"id\"."
},
"timezone": {
"type": "string",
"pattern": "^[A-Za-z0-9_+-]+(\\/[A-Za-z0-9_+-]+){0,2}$",
"description": "IANA timezone name for the air time, e.g. \"America/Los_Angeles\". Defaults to the server-configured timezone."
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Search people by name to return candidates, then select a person_id to list their cast, guest, or crew credits. Name searches never select a person automatically. Credits preserve source order and page at 50 rows by default, up to 250 per call; show_id chains to tvmaze_get_show or tvmaze_get_episodes, and guest episode_id chains to tvmaze_get_cast with scope "episode".
| Argument | Type | Description |
|---|---|---|
| limit | integer | Page size for person_id only. Defaults to 50; requests above 250 are clamped to 250. |
| query | string | Person name to search. Supply query or person_id, never both. Blank is unset. |
| cursor | string | Previous next_cursor for person_id only; the current limit sets page size. |
| person_id | integer | TVmaze person id from tvmaze_get_cast or this tool’s candidates. |
| credit_kind | string | Credit category for person_id only. Defaults to cast. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page size for person_id only. Defaults to 50; requests above 250 are clamped to 250.",
"exclusiveMinimum": 0
},
"query": {
"type": "string",
"description": "Person name to search. Supply query or person_id, never both. Blank is unset."
},
"cursor": {
"type": "string",
"description": "Previous next_cursor for person_id only; the current limit sets page size."
},
"person_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "TVmaze person id from tvmaze_get_cast or this tool’s candidates.",
"exclusiveMinimum": 0
},
"credit_kind": {
"enum": [
"cast",
"guest",
"crew"
],
"type": "string",
"description": "Credit category for person_id only. Defaults to cast."
}
},
"additionalProperties": false
}List television episodes airing on a given date. Scope "linear" covers broadcast and cable networks in one country; "streaming" covers streaming services — global services such as Netflix and Prime Video when no country is given, or that country’s local streaming services when one is. Scope "all" merges both. The source caches schedule data for up to an hour, so a same-day listing can lag a late change.
| Argument | Type | Description |
|---|---|---|
| date | string | Date to list, ISO 8601 (YYYY-MM-DD). Defaults to today in the requested timezone. |
| limit | integer | Maximum entries to return in this call. Requests above 250 are clamped to 250. Applies to every page, including a call that passes cursor. A full day in one country runs to roughly 50 broadcast entries and over 120 global streaming entries. |
| scope | string | Which feed to read. "linear" is broadcast and cable networks; "streaming" is streaming services; "all" merges both and costs three upstream requests. |
| cursor | string | Continuation token from a previous call’s next_cursor. It carries only the position to resume from; the page size comes from limit. Omit for the first page. |
| channel | string | Exact channel name, case-insensitive, such as "Netflix". Filters before paging. Blank means all channels. |
| country | string |
Fetch a television show by its TVmaze id: full profile, weekly broadcast slot, season list, and the previous and next episode when the source has them. This is the entry point for an id returned by tvmaze_search_shows or tvmaze_lookup_show. For the episode list itself use tvmaze_get_episodes, and for credits use tvmaze_get_cast.
| Argument | Type | Description |
|---|---|---|
| show_id* | integer | TVmaze show id, from tvmaze_search_shows, tvmaze_lookup_show, or tvmaze_get_schedule. |
| timezone | string | IANA timezone name for rendering the previous and next episode air times, e.g. "America/Los_Angeles" or "Europe/London". Defaults to the server-configured timezone. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"show_id"
],
"properties": {
"show_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "TVmaze show id, from tvmaze_search_shows, tvmaze_lookup_show, or tvmaze_get_schedule.",
"exclusiveMinimum": 0
},
"timezone": {
"type": "string",
"pattern": "^[A-Za-z0-9_+-]+(\\/[A-Za-z0-9_+-]+){0,2}$",
"description": "IANA timezone name for rendering the previous and next episode air times, e.g. \"America/Los_Angeles\" or \"Europe/London\". Defaults to the server-configured timezone."
}
},
"additionalProperties": false
}Resolve a television show from its id in another catalog — IMDb, TheTVDB, or TVRage — and return the matching TVmaze profile. Use this to cross a show id from another source into TVmaze. A show absent from TVmaze is reported as a miss with guidance, not an error.
No arguments.
{
"type": "object",
"oneOf": [
{
"type": "object",
"required": [
"source",
"external_id"
],
"properties": {
"source": {
"type": "string",
"const": "imdb",
"description": "Look up by IMDb title id."
},
"external_id": {
"type": "string",
"pattern": "^tt\\d{7,}$",
"description": "IMDb title id including the \"tt\" prefix, e.g. \"tt0903747\"."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"source",
"external_id"
],
"properties": {
"source": {
"type": "string",
"const": "thetvdb",
"description": "Look up by TheTVDB series id."
},
"external_id": {
"type": "string",
"pattern": "^\\d+$",
"description": "TheTVDB series id as digits, e.g. \"81189\"."
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"source",
"external_id"
],
"properties": {
"source": {
"type": "string",
"const": "tvrage",
"description": "Look up by TVRage show id. TVRage is defunct; these ids appear only in older records."
},
"external_id": {
"type": "string",
"pattern": "^\\d+$",
"description": "TVRage show id as digits."
}
},
"additionalProperties": false
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Search television shows by title and return up to 10 matches, each with its network or streaming service, production status, genres, rating, and ids in other catalogs. Matching is fuzzy, so small typos still resolve. The result set is hard-capped at 10 by the source and cannot be paged — narrow the title to reach an eleventh match. To go the other way, from an IMDb or TheTVDB id to a show, use tvmaze_lookup_show.
| Argument | Type | Description |
|---|---|---|
| query* | string | Show title or title fragment. Matched fuzzily against every show title in the database, so minor misspellings still resolve. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Show title or title fragment. Matched fuzzily against every show title in the database, so minor misspellings still resolve."
}
},
"additionalProperties": false
}| timezone | string | IANA timezone name for the air times, e.g. "America/Los_Angeles". Defaults to the server-configured timezone. |
| include_specials | boolean | Include specials alongside regular episodes. Off by default because specials roughly double the result count on a series that has many; when off, notice reports how many were left out. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"show_id"
],
"properties": {
"limit": {
"type": "integer",
"default": 50,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Maximum episodes to return in this call. Requests above 250 are clamped to 250. Applies to every page, including a call that passes cursor. Raise it for a short series; the default keeps a long run inside a reasonable response size."
},
"cursor": {
"type": "string",
"description": "Continuation token from a previous call’s next_cursor. It carries only the position to resume from; the page size comes from limit. Omit for the first page."
},
"season": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Season number to list, as numbered in the season list from tvmaze_get_show. Omit, together with air_date, to list every episode of the series. Daily shows number seasons by calendar year.",
"exclusiveMinimum": 0
},
"show_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "TVmaze show id, from tvmaze_search_shows, tvmaze_lookup_show, or tvmaze_get_schedule.",
"exclusiveMinimum": 0
},
"air_date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date to list, ISO 8601 (YYYY-MM-DD): the episodes the source dates to that day. It matches the source’s airdate, the broadcaster’s own programming day, so on a late-night slot it can differ by a day from the local_date an episode reports. Cannot be combined with season."
},
"timezone": {
"type": "string",
"pattern": "^[A-Za-z0-9_+-]+(\\/[A-Za-z0-9_+-]+){0,2}$",
"description": "IANA timezone name for the air times, e.g. \"America/Los_Angeles\". Defaults to the server-configured timezone."
},
"include_specials": {
"type": "boolean",
"default": false,
"description": "Include specials alongside regular episodes. Off by default because specials roughly double the result count on a series that has many; when off, notice reports how many were left out."
}
},
"additionalProperties": false
}| ISO 3166-1 alpha-2 country code, e.g. "US", "GB", "JP". The United Kingdom is "GB". Required in effect for scopes "linear" and "all" — omitted, it falls back to the server-configured country. For scope "streaming", omitting it selects global streaming services rather than one country’s local ones. |
| timezone | string | IANA timezone name for the air times, e.g. "America/Los_Angeles". Defaults to the server-configured timezone. Also decides what "today" means when date is omitted. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Date to list, ISO 8601 (YYYY-MM-DD). Defaults to today in the requested timezone."
},
"limit": {
"type": "integer",
"default": 50,
"maximum": 9007199254740991,
"minimum": 1,
"description": "Maximum entries to return in this call. Requests above 250 are clamped to 250. Applies to every page, including a call that passes cursor. A full day in one country runs to roughly 50 broadcast entries and over 120 global streaming entries."
},
"scope": {
"enum": [
"linear",
"streaming",
"all"
],
"type": "string",
"default": "linear",
"description": "Which feed to read. \"linear\" is broadcast and cable networks; \"streaming\" is streaming services; \"all\" merges both and costs three upstream requests."
},
"cursor": {
"type": "string",
"description": "Continuation token from a previous call’s next_cursor. It carries only the position to resume from; the page size comes from limit. Omit for the first page."
},
"channel": {
"type": "string",
"description": "Exact channel name, case-insensitive, such as \"Netflix\". Filters before paging. Blank means all channels."
},
"country": {
"type": "string",
"pattern": "^[A-Za-z]{2}$",
"description": "ISO 3166-1 alpha-2 country code, e.g. \"US\", \"GB\", \"JP\". The United Kingdom is \"GB\". Required in effect for scopes \"linear\" and \"all\" — omitted, it falls back to the server-configured country. For scope \"streaming\", omitting it selects global streaming services rather than one country’s local ones."
},
"timezone": {
"type": "string",
"pattern": "^[A-Za-z0-9_+-]+(\\/[A-Za-z0-9_+-]+){0,2}$",
"description": "IANA timezone name for the air times, e.g. \"America/Los_Angeles\". Defaults to the server-configured timezone. Also decides what \"today\" means when date is omitted."
}
},
"additionalProperties": false
}