# TV Episode Sentinel is your TV watcher. AI Agent Connect > TV Episode Sentinel turns your agent into a dedicated TV watcher. It answers the questions you actually care about, like what new episodes aired since you last checked, when the next episode is scheduled, and if a season is finally finished. It is stateless and requires no account, making it a lightweight way to keep your watchlist updated through your AI client. ## Overview - **Category:** media-entertainment - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_kGqSG1p2KXQHXmadOezOfamKEcDXp3CCQKjJyEdx/ai-agent-connect - **Tags:** tv, episodes, seasons, tvmaze, shows, new-episodes, sentinel, television ## Description You shouldn't have to manually check TV guides every week to see if your favorite shows have new episodes. This MCP gives your agent the ability to monitor the TVmaze catalog for you. Instead of your agent fetching the entire history of a show every time, you can pass a specific date to get only the new episodes that aired since your last check. This makes it incredibly efficient for running weekly updates. You can check up to five shows at once in a single call, which keeps things fast and avoids hitting rate limits. Whether you want to know if a season is complete or when the next episode is hitting the airwaves, your agent can pull that data instantly. Because it is stateless, you just keep track of the last check date in your own notes, and the MCP handles the rest. It is a clean, direct way to turn any MCP-compatible client into a personalized television assistant. ## Tools ### next_aire This tool identifies the next scheduled episode for a show. It provides the air date, season, episode number, and the network. ### season_progress This tool 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. ### show_overview This tool provides a full summary of a show, including its status, network, schedule, and all season premiere and finale dates. ### find_shows This tool searches the TV catalog to find shows by name or keyword. It returns TVmaze IDs that you can use to make other tool calls more efficient. ### new_episodes_since This tool 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. ### watchlist_delta This tool checks for new episodes across up to five shows in a single request. It is designed to be efficient and avoid hitting rate limits. ## Prompt Examples **Prompt:** ``` Which new episodes of The Pitt aired since 2026-09-01? ``` **Response:** ``` The Pitt had two new episodes aired since 2026-09-01: Episode 4 on Sept 5 and Episode 5 on Sept 12. ``` **Prompt:** ``` Check my watchlist: The Pitt, Severance, and The Bear. What is new since last week? ``` **Response:** ``` Since last week, The Pitt aired one new episode. Severance and The Bear have no new episodes recorded. ``` **Prompt:** ``` Is season 2 of Severance complete yet? ``` **Response:** ``` Season 2 of Severance is still in progress. 4 episodes have aired out of 8 total known episodes. ``` ## Capabilities ### Delta Tracking Your agent uses this to find only the episodes that aired after a specific date. ### Batch Watchlists Your agent can check multiple shows at once to save time and stay within rate limits. ### Season Auditing Your agent can determine if a season is finished or how many episodes are left. ### Show Discovery Your agent can resolve show names into unique IDs to perform more precise queries. ### Schedule Monitoring Your agent can look up the exact air date and network for upcoming episodes. ## Use Cases ### Weekly Watchlist Updates Ask your agent every Monday what new episodes aired for your five favorite shows since the previous Monday. ### Season Completion Tracking Check if a specific season has concluded so you know when to start binge-watching the next one. ### Automated Notifications Use the delta tool to feed an automation that only triggers when new episode data is found. ### Schedule Planning Find out exactly when the next episode of a show will air to plan your viewing schedule. ## Benefits - Reduces API load by batching multiple show checks into one call. - Eliminates the need for a database by using a stateless delta pattern. - Provides precise air date information without manual searching. - Works with any MCP-compatible client like Claude or Cursor. ## How It Works The MCP connects your agent to the TVmaze catalog for instant, stateless data retrieval. 1. Connect your preferred AI client to the Vinkius hosted MCP. 2. Use the find_shows tool to get the ID for your favorite series. 3. Ask your agent to check for new episodes since a specific date. 4. Store that date in your agent's context or notes for the next check. 5. Repeat the process weekly to get only the new episode updates. ## Frequently Asked Questions **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 tool 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 tool helps resolve names to IDs, and the watchlist tool 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 tool tells you so explicitly instead of failing silently.