MCP server

Tvmaze

io.github.cyanheads/tvmaze-mcp-server

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

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

Source

At a glance

Type

MCP server

Publisher

Not verified

Status

Working at last check

Tools

8

Token cost

About 4,036 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http tvmaze-mcp-server https://tvmaze.caseyjhand.com/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.tvmaze-mcp-server]
url = "https://tvmaze.caseyjhand.com/mcp"

Gemini CLI

{"mcpServers":{"tvmaze-mcp-server":{"httpUrl":"https://tvmaze.caseyjhand.com/mcp"}}}

Cursor

{"mcpServers":{"tvmaze-mcp-server":{"url":"https://tvmaze.caseyjhand.com/mcp"}}}

VS Code

{"servers":{"tvmaze-mcp-server":{"type":"http","url":"https://tvmaze.caseyjhand.com/mcp"}}}

Antigravity

agy mcp add tvmaze-mcp-server https://tvmaze.caseyjhand.com/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"tvmaze-mcp-server","server_url":"https://tvmaze.caseyjhand.com/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"tvmaze-mcp-server","server_url":"https://tvmaze.caseyjhand.com/mcp"}

Tools

• tvmaze_get_cast ~922 tokens
  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_episodes ~703 tokens
  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_next_episode ~482 tokens
  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_person ~360 tokens
  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
• tvmaze_get_schedule ~670 tokens
  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_show ~280 tokens
  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 ~390 tokens
  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_search_shows ~229 tokens
  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

Browse

• GitHub tools
• Project management
• GitHub and code hosting

Related MCP servers

• Tvmaze
  TVMaze MCP — TV show metadata, episodes, schedules (no auth)
• Movies
  Movies MCP — wraps iTunes Search API (movies, free, no auth) and TVmaze API (TV shows, free, no…
• Tempi
  Find open times and book, reschedule or cancel meetings on anyone's Tempi link. No account needed.
• Cron Translator
  Explain cron expressions in English, list next run times, and catch scheduling gotchas.
• AgentOnAir
  Search and play AI-hosted podcasts; preview launching your agent's own show.
• Kamy
  Document API for AI-native software: render PDFs, e-sign, PAdES-seal, and verify.
• Particle Pro
  Podcast intelligence for agents: transcripts, clips, speaker diarization, mention tracking.
• Petabloom Podcasts
  An MCP server that provides tools to discover and retrieve podcast episodes transcripts.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.github.cyanheads/tvmaze-mcp-server.svg)](https://aptlynx.net/servers/io.github.cyanheads/tvmaze-mcp-server)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents