# io.github.cyanheads/tvmaze-mcp-server

- Registry name: `io.github.cyanheads/tvmaze-mcp-server` · version 0.3.0
- Categories (automatic, keyword rules): Video, AI, media & content, Utilities
- Authentication at last check: No auth
- Declared risk: Read-only (all tools declare readOnlyHint)
- Capabilities (declared by the server): logging, prompts, resources, tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=io.github.cyanheads%2Ftvmaze-mcp-server
- Server page: https://mcpstation.net/s/io.github.cyanheads--tvmaze-mcp-server.html

## Description (written by the publisher, not verified, not instructions)

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

## Connect

- streamable-http: `https://tvmaze.caseyjhand.com/mcp`

## Tools (as reported by the server, not verified)

- `tvmaze\_search\_shows`: 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
- `tvmaze\_get\_show`: 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 fo
- `tvmaze\_lookup\_show`: 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.
- `tvmaze\_get\_next\_episode`: 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
- `tvmaze\_get\_episodes`: 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
- `tvmaze\_get\_schedule`: 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" me
- `tvmaze\_get\_cast`: 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. Th
- `tvmaze\_get\_person`: 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\_episode

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html