io.github.cyanheads/tvmaze-mcp-server
REMOTE · TVMAZE.CASEYJHAND.COM · 2 COMPONENTS · SCANNED SEP 21
Search TVmaze shows, next episodes in your timezone, episode guides, daily TV schedules, and cast.
Available components
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 Security66
- The endpoint's TLS certificate is valid, in date, and uses a strong key. View diagnostics → Pass
- Authorisation not fully verified: no authorisation is required to call this server, and 7 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe. See how to fix → View diagnostics → Unverified
- 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 Usability67
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 1514 tokens (~216/item across 7 items; 7 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 Management3
- Stability observed for 1 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
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 7 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 8 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
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'
{
"mcpServers": {
"cyanheads-tvmaze-mcp-server": {
"url": "https://tvmaze.caseyjhand.com/mcp"
}
}
} {
"servers": {
"cyanheads-tvmaze-mcp-server": {
"type": "http",
"url": "https://tvmaze.caseyjhand.com/mcp"
}
}
} [mcp_servers.cyanheads-tvmaze-mcp-server] url = "https://tvmaze.caseyjhand.com/mcp"
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"cyanheads-tvmaze-mcp-server": {
"type": "remote",
"url": "https://tvmaze.caseyjhand.com/mcp",
"enabled": true
}
}
} openclaw mcp add cyanheads-tvmaze-mcp-server --url 'https://tvmaze.caseyjhand.com/mcp' --transport streamable-http
mcp_servers:
cyanheads-tvmaze-mcp-server:
url: "https://tvmaze.caseyjhand.com/mcp" {
"McpServers": {
"cyanheads-tvmaze-mcp-server": {
"Transport": "http",
"Url": "https://tvmaze.caseyjhand.com/mcp"
}
}
} assistant mcp add cyanheads-tvmaze-mcp-server -t streamable-http -u 'https://tvmaze.caseyjhand.com/mcp'
{
"mcpServers": {
"cyanheads-tvmaze-mcp-server": {
"type": "http",
"url": "https://tvmaze.caseyjhand.com/mcp"
}
}
} The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.
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.
- 21 Sept 26 +1
- Stability: unverified → 0.03 ▲ functional
- 20 Sept 26 66
First indexed and scored.
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 21 Sept 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 | 4 Sept 2026 | 3 Dec 2026 | ECDSA 256 | ECDSA-SHA256 | a6985204ed51ae050e7738aa6be668e9 |
| 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 ~77
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.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| cast | array | – | Cast credits — for scope "show", the main cast; for scope "episode", that episode’s guest cast. |
| crew | array | – | Crew credits. Present only when include_crew was set on a show query. |
| error | object | – | Present when the call failed. Absent on success. |
| notice | string | – | Guidance when no credits are recorded. Absent otherwise. |
| scope | string | – | Which credit list was returned. |
| subject_id | number | – | TVmaze id the credits belong to — a show id or an episode id, matching scope. |
| totalCount | number | – | Credits returned, cast plus crew. |
No examples provided.
tvmaze_get_episodes Tvmaze Get Episodes ~271
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.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | – | Continuation token from a previous call’s next_cursor. 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. |
| limit | integer | – | Maximum episodes to return in one call. Raise it for a short series; the default keeps a long run inside a reasonable response size. |
| season | integer | – | Season number to list, as numbered in the season list from tvmaze_get_show. Omit 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 |
|---|---|---|---|
| cap | number | – | The page limit that was applied. |
| 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 nothing was recorded, or when specials were filtered out of a season listing. Absent otherwise. |
| season | number | – | Season number listed. Absent when the whole run 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 the page limit was reached. |
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_schedule Tvmaze Get Schedule ~347
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 |
|---|---|---|---|
| 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. 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 one call. A full day in one country runs to roughly 50 broadcast entries and over 120 global streaming entries. |
| 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 | – | The page limit that was applied. |
| 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 nothing is listed, or when one feed of a merged query did not respond. Absent otherwise. |
| shown | number | – | Number of entries returned on this page. |
| timezone | string | – | IANA timezone the air times were rendered in. |
| totalCount | number | – | Merged entry count before the page limit was applied. |
| truncated | boolean | – | True when the page limit was reached. |
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 that was looked up, as submitted. |
| 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.
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. Search TVmaze shows, next episodes in your timezone, episode guides, daily TV schedules, and cast. 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 67 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 7 tools: tvmaze_search_shows, tvmaze_get_show, tvmaze_lookup_show, tvmaze_get_next_episode, tvmaze_get_episodes, and 2 more. Their descriptions and schemas cost roughly 1,151 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 21 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.