{"openapi":"3.1.0","info":{"title":"Screen API","version":"0.1.0","description":"TV shows, episodes, tonight's schedule and people (TVMaze); anime and manga (AniList); film summaries.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://screen.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/screen/docs"},"termsOfService":"https://connectorbay.com/screen/terms"},"servers":[{"url":"https://screen.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/screen/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/show_search":{"post":{"operationId":"show_search","summary":"Find TV shows by title: status (Running/Ended/To Be Determined), genres, network or streaming service, schedule,","description":"Find TV shows by title: status (Running/Ended/To Be Determined), genres, network or streaming service, schedule,\n    rating, premiere/end dates, short summary, IMDb id and TVMaze link. Use for \"is Severance still running\", \"what\n    network is The Bear on\", \"find the show about…\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Show title (or part).","examples":["Severance","The Bear"],"title":"Query","type":"string"},"max_results":{"default":6,"maximum":15,"minimum":1,"title":"Max Results","type":"integer"}},"required":["query"],"title":"show_searchArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/show":{"post":{"operationId":"show","summary":"A show in full: details, next and previous episode (with air dates), seasons with episode counts, and the main","description":"A show in full: details, next and previous episode (with air dates), seasons with episode counts, and the main\n    cast with characters. Use for \"when is the next episode of X\", \"how many seasons does Y have\", \"who is in Z\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Show title (best match).","examples":["Severance"],"title":"Name"},"show_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"TVMaze show id, if known.","title":"Show Id"}},"title":"showArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/episodes":{"post":{"operationId":"episodes","summary":"The episode guide of a show — every episode (or one season) with season/number, title, air date and rating —","description":"The episode guide of a show — every episode (or one season) with season/number, title, air date and rating —\n    for \"list season 2 of X\", \"how many episodes has Y aired\", \"when did the finale air\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Show title.","examples":["The Bear"],"title":"Name"},"show_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"TVMaze show id.","title":"Show Id"},"season":{"anyOf":[{"maximum":100,"minimum":0,"type":"integer"},{"type":"null"}],"default":null,"description":"Only this season.","title":"Season"},"max_results":{"default":60,"maximum":200,"minimum":1,"title":"Max Results","type":"integer"}},"title":"episodesArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/episode":{"post":{"operationId":"episode","summary":"One episode by season and number: title, air date and time, runtime, rating and summary. Use for \"what happens in","description":"One episode by season and number: title, air date and time, runtime, rating and summary. Use for \"what happens in\n    S3E7 of X\", \"when did episode 5 of season 2 air\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"maximum":100,"minimum":0,"title":"Season","type":"integer"},"number":{"maximum":500,"minimum":0,"title":"Number","type":"integer"},"name":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Show title.","examples":["Breaking Bad"],"title":"Name"},"show_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"TVMaze show id.","title":"Show Id"}},"required":["season","number"],"title":"episodeArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/on_tonight":{"post":{"operationId":"on_tonight","summary":"What is airing on a date in a country — broadcast schedule by network or the day's streaming releases — with","description":"What is airing on a date in a country — broadcast schedule by network or the day's streaming releases — with\n    show, episode, title, airtime, runtime and rating; filterable by name/genre and prime time. Use for \"what's on TV\n    tonight\", \"new episodes on streaming today\", \"is there a new Jeopardy tonight\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"default":"US","description":"ISO country code: US, GB, CA, AU, DE, FR, IN, JP…","examples":["US","GB"],"title":"Country","type":"string"},"day":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ISO date; default today.","title":"Day"},"streaming":{"default":false,"description":"Streaming/web releases instead of broadcast TV.","title":"Streaming","type":"boolean"},"query":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Filter by show name or genre.","examples":["drama","Jeopardy"],"title":"Query"},"primetime_only":{"default":false,"description":"Only 19:00–23:00 local airtime.","title":"Primetime Only","type":"boolean"},"max_results":{"default":30,"maximum":100,"minimum":1,"title":"Max Results","type":"integer"}},"title":"on_tonightArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/person":{"post":{"operationId":"person","summary":"A TV person: birthday, country, image and their cast credits — shows with the character played — newest first.","description":"A TV person: birthday, country, image and their cast credits — shows with the character played — newest first.\n    Use for \"what has X been in\", \"who is the actor in Y\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"Actor or TV personality.","examples":["Bryan Cranston"],"title":"Name","type":"string"}},"required":["name"],"title":"personArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/anime_search":{"post":{"operationId":"anime_search","summary":"Search AniList for anime or manga: type, episodes/chapters, status, aired/published, score, rank,","description":"Search AniList for anime or manga: type, episodes/chapters, status, aired/published, score, rank,\n    studios or authors, genres, synopsis, trailer, streaming and link. Use for \"find the anime Frieren\", \"manga\n    Berserk\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Anime (or manga) title.","examples":["Frieren","Berserk"],"title":"Query","type":"string"},"kind":{"default":"anime","description":"'anime' or 'manga'.","examples":["anime"],"title":"Kind","type":"string"},"max_results":{"default":6,"maximum":20,"minimum":1,"title":"Max Results","type":"integer"}},"required":["query"],"title":"anime_searchArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/anime":{"post":{"operationId":"anime","summary":"One anime or manga in full: everything from search plus relations (sequels, prequels, adaptations, source manga),","description":"One anime or manga in full: everything from search plus relations (sequels, prequels, adaptations, source manga),\n    main characters, staff and streaming links. Use for \"tell me about Frieren\", \"is there a sequel to X\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"anilist_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"AniList id.","examples":[154587],"title":"Anilist Id"},"mal_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Or a MyAnimeList id.","examples":[52991],"title":"Mal Id"},"title":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Or a title (best match).","examples":["Sousou no Frieren"],"title":"Title"},"kind":{"default":"anime","description":"'anime' or 'manga'.","examples":["anime"],"title":"Kind","type":"string"}},"title":"animeArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/anime_top":{"post":{"operationId":"anime_top","summary":"AniList top lists: highest rated, trending/airing now, upcoming, most popular or most favourited anime or manga.","description":"AniList top lists: highest rated, trending/airing now, upcoming, most popular or most favourited anime or manga.\n    Use for \"top rated anime of all time\", \"what's trending in anime\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"kind":{"default":"anime","description":"'anime' or 'manga'.","examples":["anime"],"title":"Kind","type":"string"},"list_filter":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"airing (trending, releasing now), upcoming, bypopularity, favorite; manga: publishing. Default: top rated.","examples":["airing"],"title":"List Filter"},"max_results":{"default":10,"maximum":25,"minimum":1,"title":"Max Results","type":"integer"}},"title":"anime_topArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/anime_season":{"post":{"operationId":"anime_season","summary":"The anime of the current or upcoming season with scores, studios, genres and streaming. Use for \"what's airing","description":"The anime of the current or upcoming season with scores, studios, genres and streaming. Use for \"what's airing\n    this season\", \"anime coming next season\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"which":{"default":"now","description":"'now' (current season) or 'upcoming'.","examples":["now"],"title":"Which","type":"string"},"max_results":{"default":12,"maximum":25,"minimum":1,"title":"Max Results","type":"integer"}},"title":"anime_seasonArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/film":{"post":{"operationId":"film","summary":"A film summary: title, year, overview, director and cast, image and link — from Wikipedia (or TMDB with fuller","description":"A film summary: title, year, overview, director and cast, image and link — from Wikipedia (or TMDB with fuller\n    data when configured). Use for \"tell me about the film Parasite\", \"who directed Dune\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"title":{"description":"Film title, optionally with year.","examples":["Dune 2021","Parasite"],"title":"Title","type":"string"}},"required":["title"],"title":"filmArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}