TVMaze Connector for AI agents.
15 live capabilities
Access TV show metadata and broadcast schedules instantly.
Waiting for input…
Why people use TVMaze
TVMaze for TV Metadata and Show Research
This Connector brings that data directly into your AI client. Instead of clicking through pages, you just ask for the cast, the crew, or the full episode list. You get a structured summary of exactly what you need in seconds.
What Vinkius changes
You get instant access to a massive TV database without the hassle of managing API keys.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Building a cast list for a blog
A blogger asks their agent to find the full cast of a show.
- Real-world use case 02
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.
- Real-world use case 03
Checking tonight's local TV
A fan asks what's airing in the US tonight.
Complete set · 15capabilities
The complete TVMaze capability set.
These are the exact actions your AI can choose when you ask it to work with TVMaze.
01—04
4 capabilities in this set.
Part of 15 available through TVMaze.
- 01 Capability
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.
- 02 Capability
Single search
Search for a single TV show with full details. This is best for finding a specific match quickly with embedded info.
- 03 Capability
Get episode
Get detailed info for a specific episode by its ID. This includes the summary and air date for a single entry.
- 04 Capability
Get full schedule
Get the full future TV schedule. This returns all known upcoming episodes across all networks for a broad overview.
05—08
4 capabilities in this set.
Part of 15 available through TVMaze.
- 05 Capability
Get person
Get detailed info for a specific person. This includes their bio, birthday, and birthplace for actors and crew.
- 06 Capability
Get show
Get detailed info for a specific TV show by its ID. This includes genres, ratings, and summaries for a quick overview.
- 07 Capability
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.
- 08 Capability
Get show crew
Get the crew for a TV show. This helps you find directors, writers, and production staff for a specific series.
09—12
4 capabilities in this set.
Part of 15 available through TVMaze.
- 09 Capability
Get show episodes
Get all episodes for a TV show. You can choose to include or exclude special episodes to build a full guide.
- 10 Capability
Get show seasons
Get all seasons for a TV show. It includes premiere dates and network details for every season in the database.
- 11 Capability
Get shows
Browse all TV shows in the database. This returns a list of show IDs for further exploration of the library.
- 12 Capability
Search people
Search for actors and crew by name. It uses fuzzy matching to find people even if you have the spelling slightly off.
13—15
3 capabilities in this set.
Part of 15 available through TVMaze.
- 13 Capability
Search shows
Search for TV shows by name. It ranks results by relevance and handles typos to find the exact series you want.
- 14 Capability
Get show images
Get images for a TV show. This provides URLs for posters and banners to use in your own projects.
- 15 Capability
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.
Set up in minutes
One URL. Then ask TVMaze to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use TVMaze from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_LDpJkwhpFfwwhfOomQaw5hAp2UEphl7LFZF5rSpw/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it TVMaze, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable TVMaze for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_LDpJkwhpFfwwhfOomQaw5hAp2UEphl7LFZF5rSpw/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the TVMaze URL.
- Step 03
Save and start
Save the connection and enable TVMaze in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"tvmaze": {
"url": "https://edge.vinkius.com/vk_preview_LDpJkwhpFfwwhfOomQaw5hAp2UEphl7LFZF5rSpw/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using TVMaze
Open Agent mode in chat and ask: "Using TVMaze, help me...". 15 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"tvmaze": {
"url": "https://edge.vinkius.com/vk_preview_LDpJkwhpFfwwhfOomQaw5hAp2UEphl7LFZF5rSpw/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using TVMaze
Ask Copilot: "Using TVMaze, help me...". 15 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"tvmaze": {
"url": "https://edge.vinkius.com/vk_preview_LDpJkwhpFfwwhfOomQaw5hAp2UEphl7LFZF5rSpw/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using TVMaze
Open Cascade and ask: "Using TVMaze, help me...". 15 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"tvmaze": {
"url": "https://edge.vinkius.com/vk_preview_LDpJkwhpFfwwhfOomQaw5hAp2UEphl7LFZF5rSpw/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using TVMaze
Ask Cline: "Using TVMaze, help me...". 15 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add tvmaze --transport http "https://edge.vinkius.com/vk_preview_LDpJkwhpFfwwhfOomQaw5hAp2UEphl7LFZF5rSpw/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using TVMaze
Ask Claude: "Using TVMaze, show me...". 15 tools are ready
Where the request belongs
Work TVMaze can move forward.
TV enthusiasts, media researchers, and content curators who need to pull accurate metadata without manual searching.
Media Researcher
Fact-checking show statuses and crew credits for articles or academic projects.
Content Curator
Building lists of episodes or show summaries for a blog or social media feed.
TV Superfan
Tracking what's airing tonight or finding out who played a specific character in a classic series.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsTrakt
Track TV shows and movies. search titles, get ratings, discover trending content and manage your watchlist.
TMDB (The Movie Database)
Access movie, TV show, and actor data. search, discover, and retrieve detailed metadata directly from any AI agent.
The Movie Database (TMDb)
Search movies, TV shows, people, get details, cast, trailers, and discover content via TMDb API.
Watchmode Streaming Availability
Find where to watch any movie or TV show. search streaming availability across Netflix, Disney+, HBO Max, and 200+ platforms directly from your AI agent.
Sonarr (TV)
Automate TV library management via Sonarr. list series, track episodes, and monitor download queues directly from any AI agent.
IMDB API (Unofficial)
Search movies and TV shows. audit ratings, cast, and metadata via IA.
Bring your own AI
Change the model, client or framework. Keep TVMaze connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about TVMaze.
The practical details behind the request, access and result.
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.
One connection away
Give your agent a direct line to TVMaze.
Connect TVMaze once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available