Tvmaze Get Episodes
tvmaze_get_episodesList 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.
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": {
"show_id": "<show_id>"
},
"name": "tvmaze_get_episodes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | 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 | No | 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 | No | 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 | Yes | TVmaze show id, from tvmaze_search_shows, tvmaze_lookup_show, or tvmaze_get_schedule. | |
| air_date | No | 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 | No | IANA timezone name for the air times, e.g. "America/Los_Angeles". Defaults to the server-configured timezone. | |
| include_specials | No | 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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | Applied page size, at most 250; present when clamped or more rows remain. | |
| show | No | The show the episodes belong to. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Number of episodes returned on this page. | |
| notice | No | Guidance when the page was truncated, when nothing was recorded, or when specials were filtered out — every one that applies, joined. Absent otherwise. | |
| season | No | Season number listed. Absent when the whole run or one air date was listed. | |
| air_date | No | Air date listed, YYYY-MM-DD. Absent unless air_date was given. | |
| episodes | No | Episodes in airing order. | |
| has_more | No | True when more episodes remain beyond this page. | |
| timezone | No | IANA timezone the air times were rendered in. | |
| truncated | No | True when more matching episodes remain. | |
| totalCount | No | Episodes matching before the page limit was applied. | |
| next_cursor | No | Pass as cursor to fetch the next page. Absent on the last page. |