Tvmaze MCP Server is answering right now. Last checked 3 min ago. 93 installs a week from npm. It exposes 8 tools. Last commit 18 Oct 2026.
TVmaze shows, people, next episodes in your timezone, episode guides, schedules, and credits.
Installs per day
peak 203 · avg 26 · -42% w/w
a month agotoday
Uptime history
49 days of history · worst day 96%
49 days agonow
100.0%
Uptime 24h
92 of 92 checks
8
Tools
read from the server
594 ms
Response time
average over 24h
93
Installs / week
npm and PyPI
What changed 12
Every tool that appeared, vanished or quietly changed what it asks for. Recorded since 22 September 2026. No other catalogue keeps this.
16 Oct
3 tools changed the parameters they ask for
tvmaze_get_cast, tvmaze_get_episodes, tvmaze_get_schedule
16 Oct
a tool appeared
tvmaze_get_person
16 Oct
a tool changed version
9 Oct
a tool changed version
22 Sep
3 tools changed the parameters they ask for
tvmaze_get_cast, tvmaze_get_episodes, tvmaze_get_schedule
22 Sep
2 tool descriptions were rewritten
tvmaze_get_cast, tvmaze_get_episodes
22 Sep
a tool changed version
Nothing serious here today
Today is the operative word: we check Tvmaze MCP Server every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.
Connect this server
Endpoint below is the one we actually reach during checks — not the one copied from a README. Last verified 3 min ago.
run in your terminal
claude mcp add tvmaze-mcp-server --transport http https://tvmaze.caseyjhand.com/mcpSettings → Connectors → Add custom connector, then paste this address
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
{
"servers": {
"tvmaze-mcp-server": {
"type": "http",
"url": "https://tvmaze.caseyjhand.com/mcp"
}
}
}Available tools 8
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, 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.
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 because a long-running series returns hundreds of episodes. Specials are excluded unless include_specials is set, and the number left out is reported.
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_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_episodes, and guest episode_id chains to tvmaze_get_cast with scope "episode".
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
| URL | Transport | State | Latency | Checked |
|---|---|---|---|---|
| https://tvmaze.caseyjhand.com/mcp | streamable-http | answering | 611 ms | 3 min ago |
Alternatives to Tvmaze MCP Server
same job, measured the same wayTvmaze
by pipeworx-io
TVMaze MCP — TV show metadata, episodes, schedules (no auth)
Tvmaze MCP
by mrfentmen
TVMaze show search and schedules.
Cron Schedule MCP
by mrfentmen
Cron expression helper: explain a schedule in plain words and list its next run times, with
Wireflow
by wireflowinc
Make ads, product photos and videos in your brand, edit the video timeline and schedule posts.
Autovox
by autovox
Make podcast episodes, series and shows from your mail, notes, files and code. Sign in with OAuth.
ConnectYourGPT
by connectyourgpt
Your AI sends or schedules WhatsApp to people and groups from your own number. It never reads chats.
Otto
by doti
Create, edit, schedule, and publish social posts in your own voice with your Otto account.
Episodate MCP
by mrfentmen
TV show schedules from Episodate. No key required.
Tvmaze MCP Server — questions
Answers built from our own checks of this server.
What can Tvmaze MCP Server do?
It exposes 8 tools, read directly from the server on our last check. Among them: tvmaze_get_cast, tvmaze_get_episodes, tvmaze_get_next_episode, tvmaze_get_person, tvmaze_get_schedule, tvmaze_get_show and 2 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 92 of 92 checks got a reply (100.0%), average response time 594 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 in the form 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 8 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 594 ms on average, which is faster than 18% of all working MCP servers we measure. That is on the slow side — worth knowing if the tool sits inside an interactive loop. 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 93 times in the last week. Week over week that is -42%. 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?
The code is open source: it is published under the Apache-2.0 licence, written in TypeScript, 1 stars on GitHub and 4 open issues. The licence covers the code in the repository, not the hosted service at tvmaze.caseyjhand.com, which runs on its operator's own terms.