Skip to main content
Glama

Server Details

TVmaze shows, people, next episodes in your timezone, episode guides, schedules, and credits.

If you are the author of this connector, you can claim ownership. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
Status
Healthy
Uptime
100.0% over the last 24 hours
Last Tested
Transport
Streamable HTTP · MCP 2025-11-25
URL
Repository
cyanheads/tvmaze-mcp-server
GitHub Stars
1
Server Listing
tvmaze-mcp-server
ChatGPT
–
Claude
–

TDQS

A4.4/5.0

Scored across 8 tools

Disambiguation5/5

Each tool maps to a distinct resource/action: show lookup by external id, show search by title, show detail by TVmaze id, episode listing, cast/crew retrieval, person credits, next-episode lookup, and date-based schedule listing. The descriptions explicitly clarify boundaries between similar areas, such as get_show vs lookup_show and get_cast vs get_person.

Naming Consistency5/5

All tools use the same tvmaze_ prefix followed by a clear verb_noun pattern: get_cast, get_episodes, get_next_episode, get_person, get_schedule, get_show, lookup_show, search_shows. No naming convention mixing is present.

Tool Count5/5

Eight tools is well-scoped for a TVmaze API surface, with each tool covering a meaningful operation. There are no redundant tools or obvious thinness.

Completeness4/5

The set covers the main lifecycle: search, external-id lookup, show detail, episodes, cast/crew, people credits, next episode, and schedule. Minor gaps exist, such as a direct episode-by-id or season-by-id tool, but these can be worked around via get_episodes and get_show.

Available Tools

8 tools
tvmaze_get_castTvmaze Get CastA
Read-onlyIdempotent
Inspect

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.

Returns: cap, cast, crew, error, +10 more

tvmaze_get_episodesTvmaze Get EpisodesA
Read-onlyIdempotent
Inspect

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.

Inputs: show_id (required), limit, cursor, season, +3 more. Returns: cap, show, error, shown, +9 more

tvmaze_get_next_episodeTvmaze Get Next EpisodeA
Read-onlyIdempotent
Inspect

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.

Returns: show, error, found, guidance, +4 more

tvmaze_get_personGet personA
Read-onlyIdempotent
Inspect

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".

Inputs: limit, query, cursor, person_id, +1 more. Returns: cap, kind, error, shown, +10 more

tvmaze_get_scheduleTvmaze Get ScheduleA
Read-onlyIdempotent
Inspect

List 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.

Inputs: date, limit, scope, cursor, +3 more. Returns: cap, date, error, shown, +8 more

tvmaze_get_showTvmaze Get ShowA
Read-onlyIdempotent
Inspect

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.

Inputs: show_id (required), timezone. Returns: show, error, notice, seasons, +3 more

tvmaze_lookup_showTvmaze Lookup ShowA
Read-onlyIdempotent
Inspect

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.

Returns: show, error, found, source, +2 more

tvmaze_search_showsTvmaze Search ShowsA
Read-onlyIdempotent
Inspect

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.

Inputs: query (required). Returns: cap, error, shown, shows, +3 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables searching TV show metadata, episodes, and schedules via the TVMaze API with no authentication required.
      73 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables searching for movies and TV shows, retrieving detailed show information, and checking TV broadcast schedules through natural language or direct tool calls.
      86 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables searching and browsing German Mediathek programmes across ARD, ZDF, 3sat, ARTE, Phoenix and other channels, including latest broadcasts, channel or topic filtering, programme details, and direct video/subtitle links through a read-only API.
      7
      MIT
    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.