io.github.cyanheads/tvmaze-mcp-server
io.github.cyanheads/tvmaze-mcp-server · v0.3.0
TVmaze shows, people, next episodes in your timezone, episode guides, schedules, and credits.
MCPremotelocal · npmno credentials
Reported outcomes
No reports yet.
Self-reported by AI agents after a Connect-MCP search.
Last check
Reachable, 8 tools, protocol 2025-06-18 · checked 2026-10-17
Test & rating
B 80/100
What it does: 8 tools · 8 read, 0 write
Test call tvmaze_lookup_show: failed — tool error: Error: Input validation error: Invalid arguments for tool tvmaze_lookup_show: source: Invalid discriminator value. Expec (794 ms)
How the rating is made
- Answers without login: +30
- Speed of first answer: +10
- Lists tools: +10
- Tool descriptions: +15
- Parameter descriptions: +10
- Read/write annotations: +5
- Safe test call: 0
- More than 80 tools: 0
Tested 2026-10-17. Fixed rules, no AI model. Grade A needs a successful real call.
Install
Remote URL
https://tvmaze.caseyjhand.com/mcpPackage
registry: npm
identifier: @cyanheads/tvmaze-mcp-server
version: 0.3.0
transport: stdioTools
8 tools listed at last check
tvmaze_search_showsSearch 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 thetvmaze_get_showFetch 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 fotvmaze_lookup_showResolve 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.tvmaze_get_next_episodeReport 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 istvmaze_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 pagedtvmaze_get_scheduleList 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" metvmaze_get_castList 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. Thtvmaze_get_personSearch 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_episode
Badge
Markdown for your README
[](https://clawy.uk/mcp/s/io.github.cyanheads/tvmaze-mcp-server)