mcpbeat Sign in

Tvmaze MCP Server

answering

Tvmaze MCP Server is answering right now. Last checked 4 min ago. 320 installs a week from npm. It exposes 7 tools. Last commit 20 Sep 2026.

Search TVmaze shows, next episodes in your timezone, episode guides, daily TV schedules, and cast.

Installs per day peak 320 · avg 10
a month agotoday
Uptime history 30 hours of history · worst hour 50%
30 hours agonow
97.8%
Uptime 24h
89 of 91 checks
7
Tools
read from the server
414 ms
Response time
average over 24h
320
Installs / week
npm and PyPI

Tvmaze MCP Server does not always answer

Over the last week it answered 97.3% of our checks. We check every 15 minutes, so you hear about the next outage within the hour — not from your users.

Three servers free · no card

Connect this server

Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 4 min ago.

run in your terminal
claude mcp add tvmaze-mcp-server --transport http https://tvmaze.caseyjhand.com/mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "tvmaze-mcp-server": {
      "url": "https://tvmaze.caseyjhand.com/mcp"
    }
  }
}
~/.codex/config.toml
[mcp_servers.tvmaze-mcp-server]
url = "https://tvmaze.caseyjhand.com/mcp"
.cursor/mcp.json
{
  "mcpServers": {
    "tvmaze-mcp-server": {
      "url": "https://tvmaze.caseyjhand.com/mcp"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "tvmaze-mcp-server": {
      "url": "https://tvmaze.caseyjhand.com/mcp"
    }
  }
}

This one needs environment variables set before it will start: TVMAZE_BASE_URL (TVmaze API base URL. Override to point at an enterprise endpoint.), TVMAZE_USER_AGENT (User-Agent sent on every upstream request. TVmaze asks that clients identify themselves. Defaults to the server name, version, and repository URL.), TVMAZE_DEFAULT_TIMEZONE (IANA timezone used when a tool call omits 'timezone' (e.g. 'America/Los_Angeles').), TVMAZE_DEFAULT_COUNTRY (ISO 3166-1 alpha-2 country used for tvmaze_get_schedule scopes 'linear' and 'all' when 'country' is omitted.), TVMAZE_CACHE_TTL_S (Seconds to hold an upstream response in the in-process cache. 0 disables caching.), TVMAZE_MAX_CONCURRENCY (Concurrent upstream requests.), TVMAZE_REQUEST_TIMEOUT_MS (Per-request timeout in milliseconds.), MCP_HTTP_HOST (The hostname for the HTTP server.), MCP_HTTP_PORT (The port to run the HTTP server on.), MCP_HTTP_ENDPOINT_PATH (The endpoint path for the MCP server.), MCP_AUTH_MODE (Authentication mode to use: 'none', 'jwt', or 'oauth'.), MCP_LOG_LEVEL (Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').). The author declared them in the registry entry; get the values from the project itself.

Available tools 7

Read directly from the server with tools/list, grouped by what they act on. If a tool disappears, we record the date.

tvmaze
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. 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.
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; omit it 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.
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 the normal state for a series between seasons.
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" merges both. The source caches schedule data for up to an hour, so a same-day listing can lag a late change.
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 for credits use tvmaze_get_cast.
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_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 title to reach an eleventh match. To go the other way, from an IMDb or TheTVDB id to a show, use tvmaze_lookup_show.

Endpoints

URLTransportStateLatencyChecked
https://tvmaze.caseyjhand.com/mcp streamable-http answering 410 ms 4 min ago

Alternatives to Tvmaze MCP Server

same job, measured the same way
Tvmaze MCP
by mrfentmen

TVMaze show search and schedules.

local only
Tvmaze
by pipeworx-io

TVMaze MCP — TV show metadata, episodes, schedules (no auth)

36 tools answering
Movies
by pipeworx-io

Movies and TV show data — search, details, ratings, and cast from iTunes and TVmaze APIs

40 tools answering
Episodate MCP
by mrfentmen

TV show schedules from Episodate. No key required.

local only
Corral
by sebastienrousseau

Search code and symbols across every clone in your Corral workspace. Zero network calls.

local only
The Daily Smark
by thedailysmark

Pro-wrestling news, TV schedules, live events, videos and podcasts. Read-only, no auth.

6 tools answering
Cituna MCP
by cituna

Track how 6 AI engines cite your brand, daily, with live Google Search Console.

39 installs/wk local only
MCP Gerapodcast
by geraservicesuk

Discover podcasts, search episodes, fetch transcripts, subscribe to shows.

27 installs/wk local only

Tvmaze MCP Server — questions

Answers built from our own checks of this server.

What can Tvmaze MCP Server do?
It exposes 7 tools, read directly from the server on our last check. Among them: tvmaze_get_cast, tvmaze_get_episodes, tvmaze_get_next_episode, tvmaze_get_schedule, tvmaze_get_show, tvmaze_lookup_show and 1 more. The full list with descriptions is on this page — we take it from the server itself via tools/list, not from a README. How MCP servers expose tools in the first place →
Is Tvmaze MCP Server working right now?
We send a real MCP handshake every 15 minutes. Over the last 24 hours 89 of 91 checks got a reply (97.8%), average response time 414 ms. The bar chart above shows every period we have measured.
How do I connect Tvmaze MCP Server?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It is a remote server, so there is nothing to install — the client connects to the address.
Does Tvmaze MCP Server need an API key?
No. Tvmaze MCP Server completed a full MCP handshake with us as an anonymous client and listed its tools without asking for anything. All 7 of them are readable on this page. This is what we observed, not what the docs claim.
How fast is Tvmaze MCP Server?
It answers our handshake in 414 ms on average, which is faster than 38% of all working MCP servers we measure. The comparison comes from our own checks across the whole registry, every 15 minutes.
How many people use Tvmaze MCP Server?
The npm package @cyanheads/tvmaze-mcp-server was installed 320 times in the last week. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Tvmaze MCP Server open source?
Yes — it is published under the Apache-2.0 licence, written in TypeScript, 1 stars on GitHub and 5 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.