io.github.cyanheads/tvmaze-mcp-server
REMOTE · TVMAZE.CASEYJHAND.COM · 2 COMPONENTS
TVmaze shows, people, next episodes in your timezone, episode guides, schedules, and credits.
Available components
Last scanned (9 hours ago)
Scores higher than 94% of remote servers
Reachable. Last reached 5 Nov 2026.
Category Entertainment and Games
How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. How we score → Why this is hard to score →
Endpoint Security83
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one. See how to fix → View diagnostics → Partial
- HTTPS is enforced; there's no plaintext access path. View diagnostics → Pass
- The HSTS (Strict-Transport-Security) header is present. View diagnostics → Pass
- DNSSEC is configured correctly; the domain's records validate against the full chain to the root. View diagnostics → Pass
Transport & Reachability100
- Verified streamable-http transport via a live MCP handshake. View diagnostics → Pass
Schema Quality & AI Usability64
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 2018 tokens (~252/item across 8 items; 8 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 8 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 9 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 20 Oct 26 +1
- Stability: 0.97 → pass security
- 18 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
- 16 Oct 26 0
- The server rewrote its instructions, which are the text every model session reads security
- Schema quality: 1726 → 2018 ▼ functional
- Server version: 0.2.1 → 0.3.0 functional
- New tool “tvmaze_get_person” functional
- “tvmaze_get_schedule” added an optional parameter “channel” cosmetic
- “tvmaze_get_schedule” reworded the description of “limit” cosmetic
- “tvmaze_get_episodes” reworded the description of “limit” cosmetic
- 15 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.
- 13 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 73 to 77. That category is still filling its 30-day observation window: 22 days of observed history at the previous scan, 23 at this one. The score rises as the window fills, whether or not the server changes.
- 11 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 67 to 70. That category is still filling its 30-day observation window: 20 days of observed history at the previous scan, 21 at this one. The score rises as the window fills, whether or not the server changes.
- 10 Oct 26 +1
- Server version: 0.2.0 → 0.2.1 functional
- 7 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 47 to 57. That category is still filling its 30-day observation window: 14 days of observed history at the previous scan, 17 at this one. The score rises as the window fills, whether or not the server changes.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 5 Nov 2026 · Probed https://tvmaze.caseyjhand.com/mcp
TLS valid
Negotiated TLS 1.3 with TLS_AES_128_GCM_SHA256 .
| Subject | Issuer | Valid from | Valid until | Key | Signature | Serial |
|---|---|---|---|---|---|---|
| CN=caseyjhand.com | CN=WE1,O=Google Trust Services,C=US | 2 Nov 2026 | 31 Jan 2027 | ECDSA 256 | ECDSA-SHA256 | 995a30681ab772540e934241ca1d576c |
| SANs: caseyjhand.com, *.caseyjhand.com | ||||||
| CN=WE1,O=Google Trust Services,C=US (CA) | CN=GTS Root R4,O=Google Trust Services LLC,C=US | 13 Dec 2023 | 20 Feb 2029 | ECDSA 256 | ECDSA-SHA384 | 7ff31977972c224a76155d13b6d685e3 |
| CN=GTS Root R4,O=Google Trust Services LLC,C=US (CA) | CN=GlobalSign Root CA,OU=Root CA,O=GlobalSign nv-sa,C=BE | 15 Nov 2023 | 28 Jan 2028 | ECDSA 384 | SHA256-RSA | 7fe530bf331343bedd821610493d8a1b |
Background: What to check on a remote MCP endpoint →
DNSSEC secure
Validation of tvmaze.caseyjhand.com. — Secure
| Zone | DS | Keys | Algorithms | Outcome |
|---|---|---|---|---|
| . | trust_anchor | 20326, 38696 | 8, 8 | Verified |
| com. | present | 19718 | 13 | Verified |
| caseyjhand.com. | present | 2371 | 13 | Verified |
| tvmaze.caseyjhand.com. | Verified address RRset verified with the apex keys |
Authentication No authorisation required
The endpoint answered without asking for a token. Anyone who knows the URL can reach it.
| Result | No authorisation required |
|---|---|
| HTTP status | 200 |
| Header | Value |
|---|---|
| strict-transport-security | max-age=63072000; includeSubDomains; preload |
| x-content-type-options | nosniff |
Background: How OAuth 2.1 works in the 2026 MCP spec →
Transports 2 probes
| Transport | URL | Outcome | Status | Location |
|---|---|---|---|---|
| streamable-http | https://tvmaze.caseyjhand.com/mcp | Verified | 200 | |
| http (plaintext) | http://tvmaze.caseyjhand.com/mcp | HTTPS enforced | 301 | https://tvmaze.caseyjhand.com/mcp |
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
tvmaze_get_cast Tvmaze Get Cast ~114
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.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| cap | number | – | Applied page size, at most 250; present when clamped or more rows remain. |
| cast | array | – | Cast credits on this page — for scope "show", the main cast; for scope "episode", that episode’s guest cast. Empty on a page past the last cast row. |
| cast_total | number | – | Matching cast credits across every page. |
| crew | array | – | Crew credits on this page — for scope "show", the show’s crew; for scope "episode", that episode’s guest crew. Present, possibly empty, whenever include_crew was set; crew rows follow every cast row,… |
| crew_total | number | – | Matching crew credits across every page. Present when include_crew was set. |
| error | object | – | Present when the call failed. Absent on success. |
| has_more | boolean | – | True when more credits remain beyond this page. |
| next_cursor | string | – | Pass as cursor to fetch the next page. Absent on the last page. |
| notice | string | – | Guidance when the page was truncated, or when no cast is recorded — every one that applies, joined. Absent otherwise. |
| scope | string | – | Which credit list was returned. |
| shown | number | – | Number of credits returned on this page. |
| subject_id | number | – | TVmaze id the credits belong to — a show id or an episode id, matching scope. |
| totalCount | number | – | Matching credits across every page, cast plus crew. |
| truncated | boolean | – | True when more matching credits remain. |
No examples provided.
tvmaze_get_episodes Tvmaze Get Episodes ~429
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.
| Name | Type | Req | Description |
|---|---|---|---|
| air_date | string | – | Date to list, ISO 8601 (YYYY-MM-DD): the episodes the source dates to that day. It matches the source’s airdate, the broadcaster’s own programming day, so on a late-night slot it can differ by a day… |
| cursor | string | – | Continuation token from a previous call’s next_cursor. It carries only the position to resume from; the page size comes from limit. Omit for the first page. |
| include_specials | boolean | – | Include specials alongside regular episodes. Off by default because specials roughly double the result count on a series that has many; when off, notice reports how many were left out. |
| limit | integer | – | Maximum episodes to return in this call. Requests above 250 are clamped to 250. Applies to every page, including a call that passes cursor. Raise it for a short series; the default keeps a long run i… |
| season | integer | – | Season number to list, as numbered in the season list from tvmaze_get_show. Omit, together with air_date, to list every episode of the series. Daily shows number seasons by calendar year. |
| show_id | integer | yes | TVmaze show id, from tvmaze_search_shows, tvmaze_lookup_show, or tvmaze_get_schedule. |
| timezone | string | – | IANA timezone name for the air times, e.g. "America/Los_Angeles". Defaults to the server-configured timezone. |
| Name | Type | Req | Description |
|---|---|---|---|
| air_date | string | – | Air date listed, YYYY-MM-DD. Absent unless air_date was given. |
| cap | number | – | Applied page size, at most 250; present when clamped or more rows remain. |
| episodes | array | – | Episodes in airing order. |
| error | object | – | Present when the call failed. Absent on success. |
| has_more | boolean | – | True when more episodes remain beyond this page. |
| next_cursor | string | – | Pass as cursor to fetch the next page. Absent on the last page. |
| notice | string | – | Guidance when the page was truncated, when nothing was recorded, or when specials were filtered out — every one that applies, joined. Absent otherwise. |
| season | number | – | Season number listed. Absent when the whole run or one air date was listed. |
| show | object | – | The show the episodes belong to. |
| shown | number | – | Number of episodes returned on this page. |
| timezone | string | – | IANA timezone the air times were rendered in. |
| totalCount | number | – | Episodes matching before the page limit was applied. |
| truncated | boolean | – | True when more matching episodes remain. |
No examples provided.
tvmaze_get_next_episode Tvmaze Get Next Episode ~85
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.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | Present when the call failed. Absent on success. |
| found | boolean | – | True when a next episode is scheduled. |
| guidance | string | – | What to do next when no next episode was returned. Absent on a hit. |
| miss_reason | string | – | Why no next episode was returned. "show_not_found" means the title or id resolved to nothing; "no_scheduled_episode" means the show exists but has nothing on the schedule. |
| next_episode | object | – | The next scheduled episode. Absent on a miss. |
| previous_episode | object | – | The most recently aired episode. Returned on a hit and on a "no_scheduled_episode" miss, so a between-seasons answer still says where the show left off. |
| show | object | – | The show the answer is about. Absent when the show itself could not be resolved. |
| timezone | string | – | IANA timezone the air times were rendered in. |
No examples provided.
tvmaze_get_person Get person ~206
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".
| Name | Type | Req | Description |
|---|---|---|---|
| credit_kind | string | – | Credit category for person_id only. Defaults to cast. |
| cursor | string | – | Previous next_cursor for person_id only; the current limit sets page size. |
| limit | integer | – | Page size for person_id only. Defaults to 50; requests above 250 are clamped to 250. |
| person_id | integer | – | TVmaze person id from tvmaze_get_cast or this tool’s candidates. |
| query | string | – | Person name to search. Supply query or person_id, never both. Blank is unset. |
| Name | Type | Req | Description |
|---|---|---|---|
| candidates | array | – | Name search candidates, in source order. Never automatically selected. |
| cap | number | – | Applied page size or possible source search ceiling. |
| credit_kind | string | – | Credit category returned for the selected person. |
| credits | array | – | Selected credits on this page, in source order. |
| effectiveQuery | string | – | Trimmed person name searched. |
| error | object | – | Present when the call failed. Absent on success. |
| has_more | boolean | – | Whether further credit rows remain. |
| kind | string | – | Search candidates or one selected person with credits. |
| next_cursor | string | – | Continuation token for the selected credit list. |
| notice | string | – | Candidate selection, empty result, paging, and clamp guidance. |
| person | object | – | Selected person profile. |
| shown | number | – | Actual number of candidates or credits returned. |
| totalCount | number | – | Candidates returned by search, or total selected credits before paging. |
| truncated | boolean | – | More credits remain, or the source may have capped search candidates. |
No examples provided.
tvmaze_get_schedule Tvmaze Get Schedule ~414
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.
| Name | Type | Req | Description |
|---|---|---|---|
| channel | string | – | Exact channel name, case-insensitive, such as "Netflix". Filters before paging. Blank means all channels. |
| country | string | – | ISO 3166-1 alpha-2 country code, e.g. "US", "GB", "JP". The United Kingdom is "GB". Required in effect for scopes "linear" and "all" — omitted, it falls back to the server-configured country. For sco… |
| cursor | string | – | Continuation token from a previous call’s next_cursor. It carries only the position to resume from; the page size comes from limit. Omit for the first page. |
| date | string | – | Date to list, ISO 8601 (YYYY-MM-DD). Defaults to today in the requested timezone. |
| limit | integer | – | Maximum entries to return in this call. Requests above 250 are clamped to 250. Applies to every page, including a call that passes cursor. A full day in one country runs to roughly 50 broadcast entri… |
| scope | string | – | Which feed to read. "linear" is broadcast and cable networks; "streaming" is streaming services; "all" merges both and costs three upstream requests. |
| timezone | string | – | IANA timezone name for the air times, e.g. "America/Los_Angeles". Defaults to the server-configured timezone. Also decides what "today" means when date is omitted. |
| Name | Type | Req | Description |
|---|---|---|---|
| applied_feeds | array | – | Exactly which upstream feeds the results cover, e.g. ["linear:US"], ["web:global"], ["linear:GB","web:GB","web:global"]. |
| cap | number | – | Applied page size, at most 250; present when clamped or more rows remain. |
| date | string | – | Date listed, ISO 8601 (YYYY-MM-DD). |
| entries | array | – | Episodes airing on the date, earliest first. |
| error | object | – | Present when the call failed. Absent on success. |
| has_more | boolean | – | True when more entries remain beyond this page. |
| next_cursor | string | – | Pass as cursor to fetch the next page. Absent on the last page. |
| notice | string | – | Guidance when the page was truncated, when nothing is listed, or when one feed of a merged query did not respond — every one that applies, joined. Absent otherwise. |
| shown | number | – | Number of entries returned on this page. |
| timezone | string | – | IANA timezone the air times were rendered in. |
| totalCount | number | – | Matching merged entry count before paging. |
| truncated | boolean | – | True when more matching entries remain. |
No examples provided.
tvmaze_get_show Tvmaze Get Show ~158
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.
| Name | Type | Req | Description |
|---|---|---|---|
| show_id | integer | yes | TVmaze show id, from tvmaze_search_shows, tvmaze_lookup_show, or tvmaze_get_schedule. |
| timezone | string | – | IANA timezone name for rendering the previous and next episode air times, e.g. "America/Los_Angeles" or "Europe/London". Defaults to the server-configured timezone. |
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | Present when the call failed. Absent on success. |
| next_episode | object | – | The next episode scheduled to air. Absent when none is scheduled — a Running show between seasons has no next episode. |
| notice | string | – | Guidance when a Running show has no scheduled next episode. Absent otherwise. |
| previous_episode | object | – | The most recently aired episode. Absent for a show that has not premiered. |
| seasons | array | – | Every season TVmaze records, in order. Pass a season number to tvmaze_get_episodes. |
| show | object | – | Full show profile. |
| timezone | string | – | IANA timezone the episode times were rendered in. |
No examples provided.
tvmaze_lookup_show Tvmaze Lookup Show ~72
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.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| error | object | – | Present when the call failed. Absent on success. |
| external_id | string | – | Id looked up; IMDb ids use the canonical lowercase tt prefix and original digits. |
| found | boolean | – | True when the external id resolved to a TVmaze show. |
| guidance | string | – | What to do next when the lookup missed. Absent on a hit. |
| show | object | – | The resolved show. Absent on a miss. |
| source | string | – | Catalog the lookup was made against. |
No examples provided.
tvmaze_search_shows Tvmaze Search Shows ~141
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.
| Name | Type | Req | Description |
|---|---|---|---|
| query | string | yes | Show title or title fragment. Matched fuzzily against every show title in the database, so minor misspellings still resolve. |
| Name | Type | Req | Description |
|---|---|---|---|
| cap | number | – | The result ceiling the source applied. |
| effectiveQuery | string | – | The query as submitted upstream. |
| error | object | – | Present when the call failed. Absent on success. |
| notice | string | – | Guidance when nothing matched or when the ten-result ceiling was reached. Absent otherwise. |
| shown | number | – | Number of shows returned. |
| shows | array | – | Matching shows, best match first. At most 10. |
| truncated | boolean | – | True when the source's fixed ten-result ceiling was reached. |
No examples provided.
How do I install the io.github.cyanheads/tvmaze-mcp-server server?
io.github.cyanheads/tvmaze-mcp-server is a hosted endpoint at https://tvmaze.caseyjhand.com/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
remote · tvmaze.caseyjhand.com
claude mcp add --transport http cyanheads-tvmaze-mcp-server 'https://tvmaze.caseyjhand.com/mcp'
What is the io.github.cyanheads/tvmaze-mcp-server server?
io.github.cyanheads/tvmaze-mcp-server is listed in the public MCP registry as io.github.cyanheads/tvmaze-mcp-server. TVmaze shows, people, next episodes in your timezone, episode guides, schedules, and credits. This page covers its hosted endpoint (https://tvmaze.caseyjhand.com/mcp).
Is the io.github.cyanheads/tvmaze-mcp-server server safe to use?
io.github.cyanheads/tvmaze-mcp-server scores 87 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.cyanheads/tvmaze-mcp-server server expose?
io.github.cyanheads/tvmaze-mcp-server exposes 8 tools: tvmaze_search_shows, tvmaze_get_show, tvmaze_lookup_show, tvmaze_get_next_episode, tvmaze_get_episodes, and 3 more. Their descriptions and schemas cost roughly 1,619 tokens of context every time the server is loaded.
Does the io.github.cyanheads/tvmaze-mcp-server server require authentication?
No. We connected to io.github.cyanheads/tvmaze-mcp-server without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.
Is the io.github.cyanheads/tvmaze-mcp-server server still maintained?
io.github.cyanheads/tvmaze-mcp-server is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.