Loading ToolBench
Search TVmaze shows, next episodes in your timezone, episode guides, daily TV schedules, and cast via MCP. STDIO or Streamable HTTP.
Strong tool definitions with comprehensive descriptions (avg 180+ chars), well-structured schemas, and clear parameter documentation. All 7 tools follow verb_noun naming (tvmaze_get_*, tvmaze_search_*, tvmaze_lookup_*). Schemas include proper types, descriptions, and pagination support. Descriptions explain WHAT, WHEN, and dependencies. Minor gaps: no explicit error recovery guidance in descriptions, no destructive operation warnings (though all are READ_ONLY), and output schemas not formally documented in tool definitions.
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.
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.
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.
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.
Output schemas not formally documented in tool definitions. Descriptions mention what is returned (e.g., 'cast rows', 'episodes with air times') but JSON Schema output structure is not visible in the provided tool definitions.
No error recovery guidance in tool descriptions. Descriptions do not explain what to do if a lookup fails (e.g., 'show not found, try tvmaze_search_shows with a partial title'). Users must infer recovery paths.
Discriminated union parameters (scope, by) lack explicit enum constraints in schema. 'scope' accepts 'linear'|'streaming'|'all' and 'by' accepts 'id'|'title', but these are described as discriminatedUnion without formal enum type declaration visible.
Inferred effective spec: 2026-07-28+.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | A | 82 | 2026-07-28+ | v2 |
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.
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.
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.
Pagination cursor semantics not fully explained. Descriptions state 'Continuation token from a previous call's next_cursor' but do not clarify whether cursors are opaque, time-bound, or reusable across sessions.
No explicit mention of rate limits, timeouts, or caching behavior in tool descriptions. Users cannot predict latency or plan retry strategies.