eu.madeinro/rotv-mcp

Measured conclusion: Alive, not deep-tested. L2 outcome: not_attempted.

Romanian TV guide MCP: live listings, prime time, search, recommendations, MCP Apps tonight card.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "rotv-mcp": {
      "url": "https://tv.madeinro.eu/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (14)

• tv_now_on_tv read-only

  Returns the programs currently broadcasting on Romanian TV channels. Use this for "What is on TV now?" type questions. Default scope is the main channels; pass scope="all" for every channel in the guide.

  Parameters:

  • limit — integer — Max number of items to return
  • scope — string — main = the main Romanian channels (PRO TV, Antena 1, Kanal D, TVR 1/2, Digi 24, etc.); all = every channel in the guide (the live count is in tv_tonight_card stats.channelsMonitored)
  • category — string — Filter by channel category: Generaliste | Știri | Sport | Filme & Seriale | Documentare | Copii | Muzică | Altele
  • exclude_news — boolean — Drop channels whose category is "Știri" (Romanian news channels)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• tv_search_program read-only

  Search programs across all Romanian TV channels in the guide by free-text title, channel, category, and time window. Use for queries like "documentaries on Discovery tomorrow", "football on Saturday", "what is on Antena 1 right now". Time references accepted: now, tonight, tomorrow, weekend, primetime, today, YYYY-MM-DD, ISO instant, or ISO range "A/B".

  Parameters:

  • limit — integer
  • query — string — Free text to match against program title (case/diacritic-insensitive)
  • channel — string — Channel id, display name, or alias (e.g. "PRO TV", "tv-pro-tv", "HBO")
  • category — string — Channel category: Generaliste | Știri | Sport | Filme & Seriale | Documentare | Copii | Muzică | Altele
  • timeframe — string — Natural time reference: now | tonight | tomorrow | weekend | primetime | today | YYYY-MM-DD | ISO instant | ISO range "A/B"
  • exclude_news — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• tv_get_prime_time read-only

  Returns the prime-time lineup (20:00–23:00 Europe/Bucharest) for a given date, grouped by channel. Use for queries like "what is on prime time tonight" or "tomorrow night TV". By default, news channels are excluded.

  Parameters:

  • date — string — today | tomorrow | YYYY-MM-DD (interpreted in Europe/Bucharest)
  • scope — string
  • exclude_news — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• tv_recommend_today read-only

  Returns up to N ranked program recommendations for a given timeframe. Uses a deterministic scorer that rewards films / documentaries / generalist channels, penalises news, and boosts programs starting within the next hour. Use for queries like "recommend me something for tonight", "ce e bun la TV diseară".

  Parameters:

  • limit — integer
  • prefer — array — Preferred categories for ranking boost
  • timeframe — string — now | tonight | primetime | tomorrow | weekend | today | YYYY-MM-DD | ISO range "A/B"
  • exclude_news — boolean — Drop news channels and news programs

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• tv_get_title_details read-only

  Looks up a title across upcoming Romanian TV airings (next N hours, default 48) and the live streaming catalog for Romania (Netflix, HBO Max, Prime Video, Disney+, Apple TV+). Use for queries like "is Avatar on Netflix?", "when does Game of Thrones air next?".

  Parameters:

  • title (required) — string — Title to look up (case/diacritic-insensitive)
  • include_streaming — boolean — Also look up the title in Netflix / HBO Max / Prime Video / Disney+ / Apple TV+ catalog for Romania
  • upcoming_window_hours — integer — How far ahead (hours) to scan TV airings

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• tv_recommend_by_mood read-only

  Returns top-N Romanian TV programs ranked for a given mood (obosit/vesel/concentrat/romantic/familie/captivant — RO/EN aliases accepted). Combines: channel category, mood-fit (genre + duration + keywords), time proximity, and streaming cross-reference. Output includes mood_parts breakdown and freshness embedded.

  Parameters:

  • mood (required) — string — Mood: obosit | vesel | concentrat | romantic | familie | captivant (also accepts tired, happy, focused, family, thrilling, etc.)
  • limit — integer
  • prefer — array — Additional channel-category preferences (additive boost)
  • timeframe — string — now | tonight | primetime | tomorrow | weekend | today | YYYY-MM-DD | ISO range "A/B"
  • dislike_genres — array
  • dislike_keywords — array
  • include_streaming_xref — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• tv_plan_evening read-only

  Builds a TV watching plan that FILLS a window of time — either one long programme or 2-3 consecutive programmes with small gaps, ordered as a timeline. Use it when the user wants a schedule for the whole evening or a long window (3+ hours) rather than a single pick: "plan my evening", "ce văd toată seara", "fă-mi un program pentru 20–24". TV only (live Romanian EPG, no streaming titles); for ONE decision that may also be a streaming title, use tv_concierge. Accepts start time, duration budget, mood, and channel preferences. Output: ordered timeline + alternatives dropped + totals.

  Parameters:

  • mood — string
  • start — string — Start time: "now" | "HH:MM" (Europe/Bucharest) | ISO instant
  • prefer — array
  • max_gap_min — integer
  • duration_min — integer
  • max_segments — integer
  • allow_channel_switch — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• tv_compare_options read-only

  Compares 2-5 program titles by scoring each against the chosen mood, finding the next TV airing (next 48h by default) and looking each up in the streaming catalog. Returns side-by-side breakdown and a winner with reasoning.

  Parameters:

  • options (required) — array — Array of 2-5 titles (string) or { title, channel? } objects to compare
  • mood — string
  • prefer — array
  • upcoming_window_hours — integer

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• tv_find_for_couple read-only

  Finds TV programs that satisfy two people with different moods/preferences. Default fairness=strict (min(scoreA,scoreB) >= threshold — no veto). If strict returns nothing it falls back in two declared steps: first fairness=average at the SAME min_score; only if that is still empty is min_score halved. The response always carries requested_fairness, requested_min_score, the effective fairness / min_score, threshold_relaxed and degraded — tell the user when their threshold was relaxed. Returns per-person score breakdown + compromise note when one side wins by >1.5 points.

  Parameters:

  • person_a (required) — object — Preferences for person A
  • person_b (required) — object — Preferences for person B
  • limit — integer
  • fairness — string
  • min_score — number
  • timeframe — string
  • include_streaming_xref — boolean

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• tv_explain_recommendation read-only

  Returns a full score breakdown for a specific program in a given mood/context: per-component value + reason, extracted genres, streaming cross-ref, freshness, sources used, and a list of alternatives that were not picked (with the specific reason each was dropped). Use to understand or debug a recommendation.

  Parameters:

  • title (required) — string — Program title to explain
  • channel — string — Optional channel id/name/alias to disambiguate
  • context — object
  • start_utc — string — Optional ISO start time to disambiguate

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• tv_check_freshness read-only

  Reports the last-updated time of each underlying data source (EPG normalized, EPG homepage, streaming catalog), the age in minutes, the expected next refresh, and whether any source is stale (older than 1.5× the expected refresh interval).

  Parameters:

  • source — string — Optional filter for which source to report

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• tv_concierge read-only

  You have a window of free time — decide for me what to watch right now. Returns ONE primary decision (TV program OR streaming title) with confidence percentage, plus best_by_source when both TV and streaming were considered (the best TV airing in the window next to the best catalog title — present both to the user when gap_pct is small, since streaming is available any time and TV only now), full reasoning breakdown, and up to 3 diverse alternatives with explicit trade-offs (pros/cons, reason not picked). Picks across live Romanian TV EPG AND streaming catalog (Netflix, HBO Max, Disney+, Prime Video, Apple TV+, SkyShowtime). Built-in anti-noise filter automatically removes news, political talk, reality shows, talk-shows (NO manual filtering needed by the model). Built-in title dedup (handles ~46% duplicate-airing ratio in TV EPG). Built-in opportunity-cost lookahead (flags better options just outside the window). Event-aware: major broadcasts (World Cup / Euro / Champions League / finals) get an importance boost in ranking AND are always listed in the important_today field, even when the mood-based pick is something else — for questions like "what is important today?", prefer tv_important_today. PREFER THIS TOOL over tv_recommend_by_mood and tv_recommend_today whenever the user wants ONE answer / a single decision — those tools return ranked LISTS for browsing, this tool returns a DECISION. It returns exactly ONE pick and leaves the rest of the window as a pause: when the user wants the whole window FILLED with several programmes in sequence ("plan my evening", "ce văd toată seara", "fă-mi un program pentru 20–24", a TV window of 3+ hours), use tv_plan_evening instead. Routes any mood internally (obosit / vesel / concentrat / romantic / familie / captivant + EN aliases tired/happy/focused/romantic/family/thrilling). Trigger phrases: "what should I do", "decide for me", "pick for me", "I have X hours", "ce să fac", "am 2 ore", "alege tu", "mood X durată Y", "o singură decizie", "fii consilierul meu", "what to watch", "concierge me".

  Parameters:

  • mood — string — obosit | vesel | concentrat | romantic | familie | captivant (RO/EN aliases accepted)
  • prefer — array
  • window — object — Explicit window. Skips lookahead.
  • sources — array
  • min_rating — number — Hard minimum rating (0-10). When > 0, only titles with a MEASURED rating at or above it are eligible: streaming catalog rating, or the IMDb rating the TV guide declares. TV programmes without any rating (most sport, news, shows) are excluded, not waved through.
  • allow_pauses — boolean
  • risk_aversion — string — low = 3 alternatives, high = none
  • duration_hours — number — Shorthand when window is absent; starts at now.
  • exclude_keywords — array
  • max_alternatives — integer
  • exclude_categories — array — Anti-noise filter (default: all four).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• tv_important_today read-only

  What actually matters on Romanian TV today: World Cup / Euro / Champions League matches, finals, knockout games, national-team fixtures. Detected from real EPG text (titles + descriptions) with quoted evidence — the EPG has no structured event metadata, so detection is keyword-based and honest about it. Each event carries live_status (live / replay / unknown) with the evidence it was derived from; unknown means the EPG does not say whether the broadcast is live. Use this FIRST for questions like "what's important to watch today?".

  Parameters:

  • date — string — Day to scan, YYYY-MM-DD in Europe/Bucharest. Default: today.
  • limit — integer — Max number of events to return
  • min_tier — integer — 1 = only major events (World Cup, Euro, Champions League, finals); 2 = also notable ones (national-team matches, knockout games)

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• tv_tonight_card read-only

  The daily "what is worth watching tonight?" card: one main decision (importance-scored major event, or a deterministic prime-time film fallback) plus one pick per vertical — TV, streaming (official Netflix RO top 10), theater (a stage performance happening TODAY, else an online play; a future date only when nothing is on tonight, labelled as the next performance), cinema (box office ∩ today's real screenings, else one of today's most-screened films) — and measured stats. Same data as the tv.madeinro.eu homepage hero, regenerated daily. In MCP Apps-capable hosts this renders as an interactive card (ui://rotv/tonight-card).

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.