# TVMaze MCP for AI Agents AI Agent Connect > TVMaze MCP lets you search TV show databases, pull episode guides, and check broadcast schedules without needing an API key. It connects your AI client to a massive library of TV metadata, including cast lists, crew credits, and show summaries. It is designed to give you instant access to television data for research, curation, or personal use. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_LDpJkwhpFfwwhfOomQaw5hAp2UEphl7LFZF5rSpw/ai-agent-connect - **Tags:** tv-database, episode-guides, cast-info, schedules, metadata ## Description TVMaze connects your AI client to a massive database of television metadata. You can explore the world of TV shows through natural conversation without needing to handle any API keys. If you're trying to find a specific actor's filmography, check what's airing in a different country, or pull a full list of episodes for a series, this Connector handles it. It pulls in genres, ratings, cast lists, and crew credits like directors and producers. Because it's hosted on Vinkius, you get immediate access to these details without the usual setup headaches. It's a straightforward way to turn a TV database into a searchable knowledge base for your agent, making it easy to find exactly what you need without jumping between different websites. ## Tools ### get_schedule Get the TV schedule for a specific date and country. It includes show names, airtimes, and network info to help you plan your evening. ### single_search Search for a single TV show with full details. This is best for finding a specific match quickly with embedded info. ### get_episode Get detailed info for a specific episode by its ID. This includes the summary and air date for a single entry. ### get_full_schedule Get the full future TV schedule. This returns all known upcoming episodes across all networks for a broad overview. ### get_person Get detailed info for a specific person. This includes their bio, birthday, and birthplace for actors and crew. ### get_show Get detailed info for a specific TV show by its ID. This includes genres, ratings, and summaries for a quick overview. ### get_show_cast Get the cast for a TV show. It returns names and character roles for every actor to help you identify the stars. ### get_show_crew Get the crew for a TV show. This helps you find directors, writers, and production staff for a specific series. ### get_show_episodes Get all episodes for a TV show. You can choose to include or exclude special episodes to build a full guide. ### get_show_seasons Get all seasons for a TV show. It includes premiere dates and network details for every season in the database. ### get_shows Browse all TV shows in the database. This returns a list of show IDs for further exploration of the library. ### search_people Search for actors and crew by name. It uses fuzzy matching to find people even if you have the spelling slightly off. ### search_shows Search for TV shows by name. It ranks results by relevance and handles typos to find the exact series you want. ### get_show_images Get images for a TV show. This provides URLs for posters and banners to use in your own projects. ### get_person_cast_credits Get all cast credits for a person. It shows every show they've worked on and their role type across their career. ## Prompt Examples **Prompt:** ``` Who starred in 'The Bear'? ``` **Response:** ``` The main cast of **The Bear** includes: | Actor | Character | | :--- | :--- | | Jeremy Allen White | Carmy Berzatto | | Ayo Edebiri | Sydney and Billie | Ebon Moss-Bachrach | Richie | Abby Elliott | Natalie | Olivia Colman | Molly *Note: This is a primary cast list. Additional recurring characters are available upon request.* ``` **Prompt:** ``` What's on TV in the UK tonight? ``` **Response:** ``` Here is the TV schedule for the **United Kingdom** tonight: * **NCIS** - CBS (8:00 PM) * **The Voice** - NBC (8:00 PM) * **Abbott Elementary** - ABC (9:00 PM) * **FBI** - CBS (9:00 PM) Would you like to see the full list for a specific network? ``` **Prompt:** ``` Give me a summary of the Season 1 finale of Succession. ``` **Response:** ``` The Season 1 finale of **Succession** (S01E10) aired on **June 27, 2018**. **Summary:** After the death of Logan Roy, the siblings fight for control of the company. The episode concludes with a tense boardroom dynamic as the siblings navigate the power vacuum left by their father. It sets the stage for the ongoing struggle for the Roy empire. ``` ## Capabilities ### Find shows by name Search for TV series using fuzzy matching to find results even with typos. ### Pull complete show details Get genres, ratings, summaries, and network info for any show. ### List all episodes Retrieve full episode guides including air dates and season numbers. ### Get cast and crew lists See who starred in a show or who directed and wrote it. ### Check daily TV schedules Look up what's airing today or on any date in a specific country. ### Search for actors and creators Find people in the industry and see their notable credits. ### Fetch show posters and banners Get image URLs for posters and background banners for any series. ## Use Cases ### Building a cast list for a blog A blogger asks their agent to find the full cast of a show. The agent uses get_show_cast to pull a clean list of actors and characters. ### Researching a director's filmography A researcher uses search_people to find a director and then gets_person_cast_credits to see every show they've ever worked on. ### Checking tonight's local TV A fan asks what's airing in the US tonight. The agent uses get_schedule to see a curated list of shows and airtimes. ### Gathering show assets for a post A content creator uses get_show_images to grab poster and banner URLs for a series to include in a social media update. ## Benefits - No API keys required. You don't have to sign up for accounts or manage tokens to start pulling data from the database. - Fuzzy search works. You can find 'Breaking Bad' even if you have the spelling slightly off, thanks to typo tolerance. - Deep metadata access. You can get everything from cast lists to specific episode summaries with a single request. - Global schedules. You can check what's airing in the US, UK, or Brazil just by specifying the country code. - Full crew credits. You can find specific directors or writers without digging through multiple production pages. ## How It Works The bottom line is you get instant access to a massive TV database without the hassle of managing API keys. 1. Subscribe to the TVMaze MCP on the Vinkius catalog. 2. Connect your AI client to the catalog to enable the tools. 3. Ask your agent to find show details, schedules, or cast lists in plain English. ## Frequently Asked Questions **Does TVMaze MCP require an API key?** No, it does not. You can connect it to your AI client and start searching for show details or schedules immediately without any registration. **Can I search for shows even if I misspell the name?** Yes, the Connector uses fuzzy matching. It is designed to understand common typos and find the correct show even if the spelling isn't perfect. **Can it tell me who directed a specific show?** Yes, it can pull the full crew list for any show, which includes directors, writers, and other key production staff. **Does TVMaze MCP work for international TV schedules?** Yes, you can request schedules for specific countries by providing the country code, making it useful for global TV tracking. **Can I get biographies for actors?** Yes, it can retrieve detailed information for people in the industry, including their birthdays, birthplaces, and professional bios. **Can I get images for the shows I find?** Yes, the Connector provides URLs for posters, banners, and other show-related images so you can see what the series looks like. **Do I need an API key?** No! TVMaze's API is completely free and requires no authentication. Just subscribe and start searching. Rate limit is 20 requests per 10 seconds per IP. **Can I search for shows by actor name?** Yes! Use search_people with the actor's name to find them, then use get_person_cast_credits to see all shows they've appeared in. This is useful for discovering an actor's complete TV filmography. **Can I check what's on TV tonight?** Yes! Use get_schedule with a country code (e.g. 'US', 'GB', 'BR') to see today's TV schedule. Each entry includes the show name, episode, airtime and network. You can also specify a different date with the date parameter (YYYY-MM-DD). **Can I get episode summaries?** Yes! Use get_show_episodes with a show ID to get all episodes with their season/episode numbers, air dates, names and summaries. Each episode includes the runtime and image URL as well.