Do I need to create an account to use this?

No. The source data is public and anonymous, so you can use the MCP immediately without any credentials or accounts.

How does the agent remember what I have already seen?

The MCP is stateless. You simply tell your agent the date of your last check, and it will only return episodes aired after that date.

Can I check multiple shows at the same time?

Yes. The watchlist_delta capability allows you to check up to 5 shows in a single call to stay efficient.

What happens if a show name is hard to find?

The find_shows capability helps resolve names to IDs, and the watchlist capability handles unresolvable shows gracefully without failing the whole request.

Is this compatible with Claude or Cursor?

Yes. This MCP works with any MCP-compatible client, including Claude, Cursor, and Windsurf.

Do I need an account or API key?

No. Everything runs on the public anonymous endpoint (about 60 requests/minute). No signup, no key, no per-user state. the server is stateless and your agent keeps the baseline date in its own context.

How does "new since a date" work without the server remembering anything?

It's the sentinel pattern: you (or your agent's notes) keep your last-check date, pass it as since, and the server fetches the show's episode list once and returns only episodes aired on or after that date. Re-run with the newer date next week and you get just the delta. never the full history again.

What happens when I hit the rate limit?

The call returns an actionable error telling you to retry in about 60 seconds and to batch shows with watchlist_delta instead of separate calls. that one call checks up to 5 shows, which is usually comfortably under the limit.

Which shows and data does it cover?

The full TVmaze catalog (scripted, reality, animation; US and international) with episode air dates, networks, season premiere/finale dates and status. If a show isn't in TVmaze, the search capability tells you so explicitly instead of failing silently.

Download PDF Markdown Version

Connect Tv Episode Sentinel to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Stop checking TV guides and let your agent track your shows.

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

How Vinkius works: one connection, every tool, in any AI

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Complete set · 6 capabilities

The complete TVmaze capability set.

These are the exact actions your AI can choose when you ask it to work with TVmaze.

Capability set01 / 02

01-03

3 capabilities in this set.

Part of 6 available through TVmaze.

01
Next aire
This capability identifies the next scheduled episode for a show. It provides the air date, season, episode number, and the network.
02
Season progress
This capability tracks how many episodes in a season have aired compared to the total known episodes. It also provides the last and next air dates for that season.
03
Show overview
This capability provides a full summary of a show, including its status, network, schedule, and all season premiere and finale dates.

Capability set02 / 02

04-06

3 capabilities in this set.

Part of 6 available through TVmaze.

04
Find shows
This capability searches the TV catalog to find shows by name or keyword. It returns TVmaze IDs that you can use to make other capability calls more efficient.
05
New episodes since
This capability finds episodes that aired on or after a specific date. It is the primary way to ask your agent what has changed since your last check.
06
Watchlist delta
This capability checks for new episodes across up to five shows in a single request. It is designed to be efficient and avoid hitting rate limits.

One connector, every AI

TVmaze works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Building your own app? The connector is yours to use.

You don't need a client to put TVmaze to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

1144ms average. Fast in production.

TVmaze is checked daily against the live service.

Daily averagePeak 1155ms

Sep 25Today

Fastest day: 1144ms
Slowest day: 1155ms
14-day trend: Stable+1%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 6 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of TVmaze, so you can see the experience inside your AI.

It does not authenticate your account with TVmaze. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

TVmaze Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_kGqSG1p2KXQHXmadOezOfamKEcDXp3CCQKjJyEdx/mcp

Claude Desktop

Follow the steps below to connect in seconds.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
3Click Add and start a new chat — TVmaze capabilities are ready to use.

Configuration · claude_desktop_config.jsonCopy

{
  "mcpServers": {
    "tv-episode-sentinel-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_kGqSG1p2KXQHXmadOezOfamKEcDXp3CCQKjJyEdx/mcp"
    }
  }
}

Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline

Step-by-step instructions for each client are in the guide. How to connect

Guided setup for Claude? How to give Claude access to TVmaze

See all the AI clients this connector works with ↑

Who it's for

Built for the work TVmaze owners hand off.

This MCP is built for anyone who wants to automate their TV consumption tracking through an AI agent.

01
TV Watchers
People who want a weekly digest of new episodes without manually checking guides.
02
Automation Builders
Developers who want to schedule cheap, batched checks for episode updates.
03
Media Researchers
Users who need to audit air dates and season progress across the TVmaze catalog.

FAQ

Questions TVmaze owners ask.

01
Do I need to create an account to use this?
No. The source data is public and anonymous, so you can use the MCP immediately without any credentials or accounts.
02
How does the agent remember what I have already seen?
The MCP is stateless. You simply tell your agent the date of your last check, and it will only return episodes aired after that date.
03
Can I check multiple shows at the same time?
Yes. The watchlist_delta capability allows you to check up to 5 shows in a single call to stay efficient.
04
What happens if a show name is hard to find?
The find_shows capability helps resolve names to IDs, and the watchlist capability handles unresolvable shows gracefully without failing the whole request.
05
Is this compatible with Claude or Cursor?
Yes. This MCP works with any MCP-compatible client, including Claude, Cursor, and Windsurf.
06
Do I need an account or API key?
No. Everything runs on the public anonymous endpoint (about 60 requests/minute). No signup, no key, no per-user state. the server is stateless and your agent keeps the baseline date in its own context.
07
How does "new since a date" work without the server remembering anything?
It's the sentinel pattern: you (or your agent's notes) keep your last-check date, pass it as since, and the server fetches the show's episode list once and returns only episodes aired on or after that date. Re-run with the newer date next week and you get just the delta. never the full history again.
08
What happens when I hit the rate limit?
The call returns an actionable error telling you to retry in about 60 seconds and to batch shows with watchlist_delta instead of separate calls. that one call checks up to 5 shows, which is usually comfortably under the limit.
09
Which shows and data does it cover?
The full TVmaze catalog (scripted, reality, animation; US and international) with episode air dates, networks, season premiere/finale dates and status. If a show isn't in TVmaze, the search capability tells you so explicitly instead of failing silently.