# io.github.cyanheads/tvmaze-mcp-server (remote · tvmaze.caseyjhand.com)

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

- Trust score: 67/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-21

## Components

- remote · `tvmaze.caseyjhand.com`: 67/100 (this document), [markdown](https://verifymcp.io/servers/cyanheads-tvmaze-mcp-server/tvmaze.md), [page](https://verifymcp.io/servers/cyanheads-tvmaze-mcp-server/tvmaze)
- npm · `@cyanheads/tvmaze-mcp-server`: 43/100, [markdown](https://verifymcp.io/servers/cyanheads-tvmaze-mcp-server/cyanheads-tvmaze-mcp-server.md), [page](https://verifymcp.io/servers/cyanheads-tvmaze-mcp-server/cyanheads-tvmaze-mcp-server)

## Channel facts

- Endpoint: `https://tvmaze.caseyjhand.com/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.1.2`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-21.

- **Endpoint Security**: 66/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - 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.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 67/100
  - AI-judged instruction clarity (excellent).
  - 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.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 3/100
  - Stability observed for 1 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 7 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 8 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### 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.

### Claude

```bash
claude mcp add --transport http cyanheads-tvmaze-mcp-server 'https://tvmaze.caseyjhand.com/mcp'
```

### Cursor

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

### VS Code

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

### Codex

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

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cyanheads-tvmaze-mcp-server": {
      "type": "remote",
      "url": "https://tvmaze.caseyjhand.com/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add cyanheads-tvmaze-mcp-server --url 'https://tvmaze.caseyjhand.com/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  cyanheads-tvmaze-mcp-server:
    url: "https://tvmaze.caseyjhand.com/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "cyanheads-tvmaze-mcp-server": {
      "Transport": "http",
      "Url": "https://tvmaze.caseyjhand.com/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add cyanheads-tvmaze-mcp-server -t streamable-http -u 'https://tvmaze.caseyjhand.com/mcp'
```

### Other

```json
{
  "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.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-21 (score 67, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-09-20 (score 66)

First indexed and scored.

## MCP tools (7)

### `tvmaze_search_shows` (~141 tokens)

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.

Input parameters:

- `query` (string, required): Show title or title fragment. Matched fuzzily against every show title in the database, so minor misspellings still resolve.

Output parameters:

- `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.

### `tvmaze_get_show` (~158 tokens)

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.

Input parameters:

- `show_id` (integer, required): 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.

Output parameters:

- `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.

### `tvmaze_lookup_show` (~72 tokens)

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.

Output parameters:

- `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.

### `tvmaze_get_next_episode` (~85 tokens)

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.

Output parameters:

- `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.

### `tvmaze_get_episodes` (~271 tokens)

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.

Input parameters:

- `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, required): 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.

Output parameters:

- `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.

### `tvmaze_get_schedule` (~347 tokens)

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.

Input parameters:

- `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.

Output parameters:

- `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.

### `tvmaze_get_cast` (~77 tokens)

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.

Output parameters:

- `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.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/cyanheads-tvmaze-mcp-server/tvmaze#diagnostics

## Score history

- 2026-09-21: 67
- 2026-09-20: 66

## Common questions

### 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.

## Links

- Remote endpoint: https://tvmaze.caseyjhand.com/mcp
- Repository: https://github.com/cyanheads/tvmaze-mcp-server
- Changelog RSS feed: https://verifymcp.io/servers/cyanheads-tvmaze-mcp-server/tvmaze.xml
- Changelog JSON feed: https://verifymcp.io/servers/cyanheads-tvmaze-mcp-server/tvmaze.json
- HTML version of this page: https://verifymcp.io/servers/cyanheads-tvmaze-mcp-server/tvmaze