Romanian TV guide MCP: live listings, prime time, search, recommendations, MCP Apps tonight card.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
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).
Optional filter for which source to report
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).
| Argument | Type | Description |
|---|---|---|
| source | string | Optional filter for which source to report |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"source": {
"enum": [
"all",
"epg",
"streaming"
],
"type": "string",
"default": "all",
"description": "Optional filter for which source to report"
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| mood | string | |
| prefer | array | |
| options* | array | Array of 2-5 titles (string) or { title, channel? } objects to compare |
| upcoming_window_hours | integer |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"options"
],
"properties": {
"mood": {
"type": "string"
},
"prefer": {
"type": "array",
"items": {
"type": "string"
}
},
"options": {
"type": "array",
"items": {
"anyOf": [
{
"type": "string"
},
{
"type": "object",
"required": [
"title"
],
"properties": {
"title": {
"type": "string"
},
"channel": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"maxItems": 5,
"minItems": 2,
"description": "Array of 2-5 titles (string) or { title, channel? } objects to compare"
},
"upcoming_window_hours": {
"type": "integer",
"default": 48,
"maximum": 72,
"minimum": 1
}
},
"additionalProperties": false
}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".
| Argument | Type | Description |
|---|---|---|
| mood | string |
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.
| Argument | Type | Description |
|---|---|---|
| title* | 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 |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"maxLength": 200,
"minLength": 2,
"description": "Program title to explain"
},
"channel": {
"type": "string",
"description": "Optional channel id/name/alias to disambiguate"
},
"context": {
"type": "object",
"properties": {
"mood": {
"type": "string"
},
"prefer": {
"type": "array",
"items": {
"type": "string"
}
},
"timeframe": {
"type": "string"
}
},
"additionalProperties": false
},
"start_utc": {
"type": "string",
"description": "Optional ISO start time to disambiguate"
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | |
| fairness | string | |
| person_a* | object | Preferences for person A |
| person_b* | object | Preferences for person B |
| min_score | number | |
| timeframe | string | |
| include_streaming_xref | boolean |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"person_a",
"person_b"
],
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 10,
"minimum": 1
},
"fairness": {
"enum": [
"strict",
"average"
],
"type": "string",
"default": "strict"
},
"person_a": {
"type": "object",
"properties": {
"mood": {
"type": "string"
},
"prefer": {
"type": "array",
"items": {
"type": "string"
}
},
"dislike_genres": {
"type": "array",
"items": {
"type": "string"
}
},
"dislike_keywords": {
"type": "array",
"items": {
"type": "string"
}
}
},
"description": "Preferences for person A",
"additionalProperties": false
},
"person_b": {
"type": "object",
"properties": {
"mood": {
"$ref": "#/properties/person_a/properties/mood"
},
"prefer": {
"$ref": "#/properties/person_a/properties/prefer"
},
"dislike_genres": {
"$ref": "#/properties/person_a/properties/dislike_genres"
},
"dislike_keywords": {
"$ref": "#/properties/person_a/properties/dislike_keywords"
}
},
"description": "Preferences for person B",
"additionalProperties": false
},
"min_score": {
"type": "number",
"default": 1
},
"timeframe": {
"type": "string",
"default": "tonight"
},
"include_streaming_xref": {
"type": "boolean",
"default": true
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| date | string | today | tomorrow | YYYY-MM-DD (interpreted in Europe/Bucharest) |
| scope | string | |
| exclude_news | boolean |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"date": {
"type": "string",
"default": "today",
"description": "today | tomorrow | YYYY-MM-DD (interpreted in Europe/Bucharest)"
},
"scope": {
"enum": [
"main",
"all"
],
"type": "string",
"default": "main"
},
"exclude_news": {
"type": "boolean",
"default": true
}
},
"additionalProperties": false
}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?".
| Argument | Type | Description |
|---|---|---|
| title* | 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 |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"title"
],
"properties": {
"title": {
"type": "string",
"maxLength": 200,
"minLength": 2,
"description": "Title to look up (case/diacritic-insensitive)"
},
"include_streaming": {
"type": "boolean",
"default": true,
"description": "Also look up the title in Netflix / HBO Max / Prime Video / Disney+ / Apple TV+ catalog for Romania"
},
"upcoming_window_hours": {
"type": "integer",
"default": 48,
"maximum": 72,
"minimum": 1,
"description": "How far ahead (hours) to scan TV airings"
}
},
"additionalProperties": false
}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?".
| Argument | Type | Description |
|---|---|---|
| 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) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Day to scan, YYYY-MM-DD in Europe/Bucharest. Default: today."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 25,
"minimum": 1,
"description": "Max number of events to return"
},
"min_tier": {
"type": "integer",
"default": 2,
"maximum": 2,
"minimum": 1,
"description": "1 = only major events (World Cup, Euro, Champions League, finals); 2 = also notable ones (national-team matches, knockout games)"
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| 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) |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 15,
"maximum": 50,
"minimum": 1,
"description": "Max number of items to return"
},
"scope": {
"enum": [
"main",
"all"
],
"type": "string",
"default": "main",
"description": "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": {
"type": "string",
"description": "Filter by channel category: Generaliste | Știri | Sport | Filme & Seriale | Documentare | Copii | Muzică | Altele"
},
"exclude_news": {
"type": "boolean",
"default": false,
"description": "Drop channels whose category is \"Știri\" (Romanian news channels)"
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| 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 |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"mood": {
"type": "string"
},
"start": {
"type": "string",
"default": "20:00",
"description": "Start time: \"now\" | \"HH:MM\" (Europe/Bucharest) | ISO instant"
},
"prefer": {
"type": "array",
"items": {
"type": "string"
}
},
"max_gap_min": {
"type": "integer",
"default": 10,
"maximum": 30,
"minimum": 0
},
"duration_min": {
"type": "integer",
"default": 180,
"maximum": 360,
"minimum": 30
},
"max_segments": {
"type": "integer",
"default": 3,
"maximum": 3,
"minimum": 1
},
"allow_channel_switch": {
"type": "boolean",
"default": true
}
},
"additionalProperties": false
}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.
| Argument | Type | Description |
|---|---|---|
| mood* | 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 |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mood"
],
"properties": {
"mood": {
"type": "string",
"maxLength": 40,
"minLength": 2,
"description": "Mood: obosit | vesel | concentrat | romantic | familie | captivant (also accepts tired, happy, focused, family, thrilling, etc.)"
},
"limit": {
"type": "integer",
"default": 5,
"maximum": 10,
"minimum": 1
},
"prefer": {
"type": "array",
"items": {
"type": "string"
},
"description": "Additional channel-category preferences (additive boost)"
},
"timeframe": {
"type": "string",
"default": "tonight",
"description": "now | tonight | primetime | tomorrow | weekend | today | YYYY-MM-DD | ISO range \"A/B\""
},
"dislike_genres": {
"type": "array",
"items": {
"type": "string"
}
},
"dislike_keywords": {
"type": "array",
"items": {
"type": "string"
}
},
"include_streaming_xref": {
"type": "boolean",
"default": true
}
},
"additionalProperties": false
}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ă".
| Argument | Type | Description |
|---|---|---|
| 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 |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 5,
"maximum": 10,
"minimum": 1
},
"prefer": {
"type": "array",
"items": {
"enum": [
"filme",
"seriale",
"documentare",
"sport",
"copii",
"muzica"
],
"type": "string"
},
"default": [
"filme",
"documentare"
],
"description": "Preferred categories for ranking boost"
},
"timeframe": {
"type": "string",
"default": "tonight",
"description": "now | tonight | primetime | tomorrow | weekend | today | YYYY-MM-DD | ISO range \"A/B\""
},
"exclude_news": {
"type": "boolean",
"default": true,
"description": "Drop news channels and news programs"
}
},
"additionalProperties": false
}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".
| Argument | Type | Description |
|---|---|---|
| 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 |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1
},
"query": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "Free text to match against program title (case/diacritic-insensitive)"
},
"channel": {
"type": "string",
"description": "Channel id, display name, or alias (e.g. \"PRO TV\", \"tv-pro-tv\", \"HBO\")"
},
"category": {
"type": "string",
"description": "Channel category: Generaliste | Știri | Sport | Filme & Seriale | Documentare | Copii | Muzică | Altele"
},
"timeframe": {
"type": "string",
"default": "now",
"description": "Natural time reference: now | tonight | tomorrow | weekend | primetime | today | YYYY-MM-DD | ISO instant | ISO range \"A/B\""
},
"exclude_news": {
"type": "boolean",
"default": false
}
},
"additionalProperties": false
}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).
No arguments.
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {}
}| 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). |
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"mood": {
"type": "string",
"description": "obosit | vesel | concentrat | romantic | familie | captivant (RO/EN aliases accepted)"
},
"prefer": {
"type": "array",
"items": {
"type": "string"
}
},
"window": {
"type": "object",
"properties": {
"start": {
"type": "string",
"default": "now",
"description": "\"now\" | \"HH:MM\" (Europe/Bucharest) | ISO instant"
},
"duration_min": {
"type": "integer",
"default": 120,
"maximum": 360,
"minimum": 30
}
},
"description": "Explicit window. Skips lookahead.",
"additionalProperties": false
},
"sources": {
"type": "array",
"items": {
"enum": [
"tv",
"streaming"
],
"type": "string"
},
"default": [
"tv",
"streaming"
]
},
"min_rating": {
"type": "number",
"default": 0,
"maximum": 10,
"minimum": 0,
"description": "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": {
"type": "boolean",
"default": true
},
"risk_aversion": {
"enum": [
"low",
"high"
],
"type": "string",
"default": "low",
"description": "low = 3 alternatives, high = none"
},
"duration_hours": {
"type": "number",
"maximum": 6,
"minimum": 0.5,
"description": "Shorthand when window is absent; starts at now."
},
"exclude_keywords": {
"type": "array",
"items": {
"type": "string"
}
},
"max_alternatives": {
"type": "integer",
"default": 3,
"maximum": 5,
"minimum": 0
},
"exclude_categories": {
"type": "array",
"items": {
"enum": [
"politica",
"reality",
"talkshow",
"stiri"
],
"type": "string"
},
"default": [
"politica",
"reality",
"talkshow",
"stiri"
],
"description": "Anti-noise filter (default: all four)."
}
},
"additionalProperties": false
}