Tvmaze Get Schedule
tvmaze_get_scheduleList television episodes airing on a given date. Scope "linear" covers broadcast and cable networks in one country and can include timed releases on local streaming services. Scope "streaming" covers global services when no country is given, or that country’s local streaming services when one is. Scope "all" merges all three feeds for the selected country. The source caches schedule data for up to an hour, so a same-day listing can lag a late change.
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": "tvmaze_get_schedule"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | Date to list, ISO 8601 (YYYY-MM-DD). Defaults to today in the requested timezone. | |
| limit | No | 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 | No | Which feed to read. "linear" covers broadcast and cable and can include timed local streaming releases. "streaming" selects the local or global web feed based on country. "all" merges the linear, local web, and global web feeds in three upstream requests. | linear |
| 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. | |
| channel | No | Exact network or web channel name, case-insensitive, such as "Netflix". Matches either recorded carrier before paging. Blank means all channels. | |
| country | No | 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 | No | 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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | Applied page size, at most 250; present when clamped or more rows remain. | |
| date | No | Date listed, ISO 8601 (YYYY-MM-DD). | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Number of entries returned on this page. | |
| notice | No | Guidance when the page was truncated, when nothing is listed, or when one feed of a merged query did not respond — every one that applies, joined. Absent otherwise. | |
| entries | No | Episodes airing on the date, earliest first. | |
| has_more | No | True when more entries remain beyond this page. | |
| timezone | No | IANA timezone the air times were rendered in. | |
| truncated | No | True when more matching entries remain. | |
| totalCount | No | Matching merged entry count before paging. | |
| next_cursor | No | Pass as cursor to fetch the next page. Absent on the last page. | |
| applied_feeds | No | Exactly which upstream feeds the results cover, e.g. ["linear:US"], ["web:global"], ["linear:GB","web:GB","web:global"]. |