{"openapi":"3.1.0","info":{"title":"TMDB Movie Extras (BYOK) API","version":"0.1.0","description":"TMDB Movie Extras (BYOK) lets an AI assistant read your own TMDB Movie Extras data through the TMDB Movie Extras API with a key you supply (API read access token). Read-only: 10 tools (list_now_playing, list_upcoming, list_top_rated_movies, list_popular_movies, list_similar_movies, list_release_dates, list_movie_videos, list_movie_keywords, list_alternative_titles, get_movie_external_ids). The...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-tmdb-movie-extras.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-tmdb-movie-extras/docs"},"termsOfService":"https://connectorbay.com/byok-tmdb-movie-extras/terms"},"servers":[{"url":"https://byok-tmdb-movie-extras.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-tmdb-movie-extras/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_now_playing":{"post":{"operationId":"list_now_playing","summary":"List movies currently in theatres (with the date range TMDB uses), 20 per page. Use for \"Which movies are in theatres no","description":"List movies currently in theatres (with the date range TMDB uses), 20 per page. Use for \"Which movies are in theatres now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"language":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":"en-US","description":"Language of text as an ISO 639-1 code with optional region, for example 'en-US' or 'de-DE'.","title":"Language"},"page":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1 (20 results per page).","title":"Page"},"region":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"ISO 3166-1 country code to localise release dates and the list, for example 'US'.","title":"Region"}},"title":"list_now_playingArguments","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/list_upcoming":{"post":{"operationId":"list_upcoming","summary":"List movies being released soon (with the date range TMDB uses), 20 per page. Use for \"Which movies are coming out soon\"","description":"List movies being released soon (with the date range TMDB uses), 20 per page. Use for \"Which movies are coming out soon\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"language":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":"en-US","description":"Language of text as an ISO 639-1 code with optional region, for example 'en-US' or 'de-DE'.","title":"Language"},"page":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1 (20 results per page).","title":"Page"},"region":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"ISO 3166-1 country code to localise release dates and the list, for example 'US'.","title":"Region"}},"title":"list_upcomingArguments","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/list_top_rated_movies":{"post":{"operationId":"list_top_rated_movies","summary":"List movies ordered by TMDB user rating, 20 per page. Use for \"What are the best rated movies on TMDB\".","description":"List movies ordered by TMDB user rating, 20 per page. Use for \"What are the best rated movies on TMDB\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"language":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":"en-US","description":"Language of text as an ISO 639-1 code with optional region, for example 'en-US' or 'de-DE'.","title":"Language"},"page":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1 (20 results per page).","title":"Page"},"region":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"ISO 3166-1 country code to localise release dates and the list, for example 'US'.","title":"Region"}},"title":"list_top_rated_moviesArguments","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/list_popular_movies":{"post":{"operationId":"list_popular_movies","summary":"List movies ordered by current TMDB popularity, 20 per page. Use for \"What are the most popular movies on TMDB right now","description":"List movies ordered by current TMDB popularity, 20 per page. Use for \"What are the most popular movies on TMDB right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"language":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":"en-US","description":"Language of text as an ISO 639-1 code with optional region, for example 'en-US' or 'de-DE'.","title":"Language"},"page":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1 (20 results per page).","title":"Page"},"region":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"ISO 3166-1 country code to localise release dates and the list, for example 'US'.","title":"Region"}},"title":"list_popular_moviesArguments","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/list_similar_movies":{"post":{"operationId":"list_similar_movies","summary":"List movies similar to one movie by genres and keywords, 20 per page. Use for \"What movies are similar to Fight Club\".","description":"List movies similar to one movie by genres and keywords, 20 per page. Use for \"What movies are similar to Fight Club\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"movie_id":{"description":"Numeric TMDB movie id (the id of a search result), for example 550 for Fight Club.","minimum":1,"title":"Movie Id","type":"integer"},"language":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":"en-US","description":"Language of text as an ISO 639-1 code with optional region, for example 'en-US' or 'de-DE'.","title":"Language"},"page":{"anyOf":[{"maximum":500,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1 (20 results per page).","title":"Page"}},"required":["movie_id"],"title":"list_similar_moviesArguments","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/list_release_dates":{"post":{"operationId":"list_release_dates","summary":"List a movie's release dates and age certifications per country, with release type (1 premiere to 6 TV) and notes. Use f","description":"List a movie's release dates and age certifications per country, with release type (1 premiere to 6 TV) and notes. Use for \"When was Fight Club released in each country and with what rating\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"movie_id":{"description":"Numeric TMDB movie id (the id of a search result), for example 550 for Fight Club.","minimum":1,"title":"Movie Id","type":"integer"}},"required":["movie_id"],"title":"list_release_datesArguments","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/list_movie_videos":{"post":{"operationId":"list_movie_videos","summary":"List a movie's trailers, teasers and clips with site (YouTube, Vimeo), key, type and publish date. Use for \"Show the tra","description":"List a movie's trailers, teasers and clips with site (YouTube, Vimeo), key, type and publish date. Use for \"Show the trailers of Fight Club\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"movie_id":{"description":"Numeric TMDB movie id (the id of a search result), for example 550 for Fight Club.","minimum":1,"title":"Movie Id","type":"integer"},"language":{"anyOf":[{"maxLength":10,"type":"string"},{"type":"null"}],"default":"en-US","description":"Language of text as an ISO 639-1 code with optional region, for example 'en-US' or 'de-DE'.","title":"Language"}},"required":["movie_id"],"title":"list_movie_videosArguments","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/list_movie_keywords":{"post":{"operationId":"list_movie_keywords","summary":"List the keywords TMDB attaches to a movie. Use for \"What keywords describe Fight Club\".","description":"List the keywords TMDB attaches to a movie. Use for \"What keywords describe Fight Club\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"movie_id":{"description":"Numeric TMDB movie id, for example 550.","minimum":1,"title":"Movie Id","type":"integer"}},"required":["movie_id"],"title":"list_movie_keywordsArguments","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/list_alternative_titles":{"post":{"operationId":"list_alternative_titles","summary":"List a movie's alternative titles by country, optionally for one country. Use for \"What is Fight Club called in other co","description":"List a movie's alternative titles by country, optionally for one country. Use for \"What is Fight Club called in other countries\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"movie_id":{"description":"Numeric TMDB movie id, for example 550.","minimum":1,"title":"Movie Id","type":"integer"},"country":{"anyOf":[{"maxLength":2,"type":"string"},{"type":"null"}],"default":null,"description":"ISO 3166-1 country code to filter by, for example 'DE'.","title":"Country"}},"required":["movie_id"],"title":"list_alternative_titlesArguments","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/get_movie_external_ids":{"post":{"operationId":"get_movie_external_ids","summary":"Get a movie's ids on other sites: IMDb and Wikidata where TMDB has them. Use for \"What is the IMDb id of Fight Club\".","description":"Get a movie's ids on other sites: IMDb and Wikidata where TMDB has them. Use for \"What is the IMDb id of Fight Club\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"movie_id":{"description":"Numeric TMDB movie id, for example 550.","minimum":1,"title":"Movie Id","type":"integer"}},"required":["movie_id"],"title":"get_movie_external_idsArguments","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}}}}