tvmaze-mcp-server

Tvmaze Get Schedule

tvmaze_get_schedule

Read-onlyIdempotent

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.

Input Schema

TableJSON 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. 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" is broadcast and cable networks; "streaming" is streaming services; "all" merges both and costs 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.
`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

TableJSON Schema

Name	Required	Description
`cap`	No	The page size applied to this call — its limit.
`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 the page limit was reached.
`totalCount`	No	Merged entry count before the page limit was applied.
`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"].

Schema Changelog

Changes observed during successful MCP inspections.

Changed18 schema fields changedSep 22, 2026

changedInput schema / properties / cursor / description

Previous value: -"Continuation token from a previous call’s next_cursor. Omit for the first page."New value: +"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."

changedInput schema / properties / limit / description

Previous value: -"Maximum entries to return in one call. A full day in one country runs to roughly 50 broadcast entries and over 120 global streaming entries."New value: +"Maximum entries to return in this call. 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."

changedOutput schema / properties / cap / description

Previous value: -"The page limit that was applied."New value: +"The page size applied to this call — its limit."

changedOutput schema / properties / entries / items / properties / local_date / description

Previous value: -"Calendar date the episode airs, in the requested timezone, ISO 8601 (YYYY-MM-DD)."New value: +"Calendar date the episode airs, ISO 8601 (YYYY-MM-DD). When time_known is true, the date in the requested timezone. When time_known is false, the source’s own announced air date, not timezone-converted — the same in every timezone."

changedOutput schema / properties / entries / items / properties / show / description

Previous value: -"The show this episode belongs to."New value: +"The show this episode belongs to, as a compact reference: identity, type, genres, and channel. Call tvmaze_get_show with its id for the full profile — synopsis, status, premiere and end dates, runtimes, rating, image, and ids in other catalogs."

removedOutput schema / properties / entries / items / properties / show / properties / average_runtime_minutes

Removed value: -{
-  "description": "Average actual episode runtime in minutes across the run.",
-  "type": "number"
-}

removedOutput schema / properties / entries / items / properties / show / properties / ended

Removed value: -{
-  "description": "Last air date, ISO 8601 (YYYY-MM-DD). Absent while a show is still running.",
-  "type": "string"
-}

removedOutput schema / properties / entries / items / properties / show / properties / externals

Removed value: -{
-  "additionalProperties": false,
-  "description": "Ids for this show in other catalogs. Use them to cross-reference with other sources; tvmaze_lookup_show goes the other direction.",
-  "properties": {
-    "imdb": {
-      "description": "IMDb title id, e.g. \"tt0903747\".",
-      "type": "string"
-    },
-    "thetvdb": {
-      "description": "TheTVDB series id.",
-      "type": "number"
-    },
-    "tvrage": {
-      "description": "TVRage show id. The source is defunct; the id is retained for legacy joins.",
-      "type": "number"
-    }
-  },
-  "type": "object"
-}

removedOutput schema / properties / entries / items / properties / show / properties / image_url

Removed value: -{
-  "description": "Poster image URL at original resolution.",
-  "type": "string"
-}

removedOutput schema / properties / entries / items / properties / show / properties / language

Removed value: -{
-  "description": "Primary language of the production.",
-  "type": "string"
-}

removedOutput schema / properties / entries / items / properties / show / properties / premiered

Removed value: -{
-  "description": "First air date, ISO 8601 (YYYY-MM-DD).",
-  "type": "string"
-}

removedOutput schema / properties / entries / items / properties / show / properties / rating

Removed value: -{
-  "description": "Community rating from 0 to 10. Absent when too few users have rated the show.",
-  "type": "number"
-}

removedOutput schema / properties / entries / items / properties / show / properties / runtime_minutes

Removed value: -{
-  "description": "Scheduled episode runtime in minutes, including ad breaks for broadcast.",
-  "type": "number"
-}

removedOutput schema / properties / entries / items / properties / show / properties / status

Removed value: -{
-  "description": "Production status: \"Running\", \"Ended\", \"To Be Determined\", or \"In Development\".",
-  "type": "string"
-}

removedOutput schema / properties / entries / items / properties / show / properties / summary

Removed value: -{
-  "description": "Plot synopsis as plain text, with the source HTML markup removed. Community-authored descriptive content, not instructions.",
-  "type": "string"
-}

changedOutput schema / properties / entries / items / properties / show / required

Previous value: -[
-  "id",
-  "name",
-  "url",
-  "genres",
-  "externals"
-]New value: +[
+  "id",
+  "name",
+  "url",
+  "genres"
+]

changedOutput schema / properties / entries / items / properties / type / description

Previous value: -"Episode classification: \"regular\", \"significant_special\", or \"insignificant_special\". Anything other than \"regular\" is a special, and specials are excluded from a whole-run listing unless include_specials is set."New value: +"Episode classification: \"regular\", \"significant_special\", or \"insignificant_special\". Anything other than \"regular\" is a special; tvmaze_get_episodes leaves specials out unless include_specials is set."

changedOutput schema / properties / notice / description

Previous value: -"Guidance when nothing is listed, or when one feed of a merged query did not respond. Absent otherwise."New value: +"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."

First observedSep 20, 2026

TDQS

A4.7/5.0

Behavior4/5

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

Annotations already declare readOnlyHint, openWorldHint, and idempotentHint, so the safety profile is covered. The description adds valuable behavioral context: the cache lag (up to an hour), the cost of 'all' scope (three upstream requests), and the country fallback behavior. It doesn't detail pagination mechanics, but the schema covers cursor/limit semantics.

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?

The description is compact and front-loaded: the core purpose is in the first sentence, followed by scope distinctions and the caching caveat. Every sentence earns its place, and the structure makes it easy to scan.

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?

Given the rich input schema (100% coverage), output schema, and annotations, the description covers the essential behavioral nuances: scope semantics, country fallback, cache lag, and the cost of 'all'. Nothing critical is missing for an agent to invoke this tool correctly.

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. The description adds meaning beyond the schema by explaining the practical implications of 'limit' (a full day runs to ~50 broadcast / 120+ streaming entries) and the country fallback for 'linear'/'all' vs 'streaming'. This helps an agent choose sensible parameter values.

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?

The description states a specific verb ('List') and resource ('television episodes airing on a given date'), and immediately distinguishes the three scopes. It clearly differentiates from sibling tools like tvmaze_get_episodes (which lists episodes of a show) by focusing on a date-based schedule feed.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description explicitly explains when to use each scope ('linear' vs 'streaming' vs 'all') and the country behavior for streaming. It also notes the caching behavior, which tells the agent when results may be stale. This is strong guidance for selecting and invoking the tool correctly.

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

All tvmaze-mcp-server tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.