How to Use the TVMaze MCP in Cline

Q: How do I find a show's cast using TVMaze and Cline?

First, run getshow to get the show ID. Then, pipe that into getshowcast. Your agent collects every actor’s name and character name linked directly to that series for your component build.

Q: What is the best way to pull a full episode list using TVMaze and Cline?

You should use getshowepisodes. It pulls season/episode numbers, air dates, summaries, and runtimes. You can easily adjust the script logic to include specials by setting the correct flag.

Q: Can I get all known future episodes for a region using TVMaze and Cline?

Yes, use getfullschedule. It dumps every known future episode across all shows and networks. You just pass in the country code you want to restrict the results by.

Q: Do I need an API key for TVMaze MCP Server?

No, the singlesearch tool is designed specifically so that you can get embedded details like episodes and cast without needing a separate API key. It makes scripting easier.

Build TV dashboards in Cline. Execute multi-step data pulls from the terminal.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect TVMaze MCP to Cline

Create your Vinkius account to connect TVMaze to Cline and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup TVMaze with Cline

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Generating Comprehensive Episode Guides

When you need a full episode list, use `get_show_episodes`. You can get all episodes for a show and specify if you want specials included by setting `specials=true` in the call. The resulting data includes season/episode numbers, air date, runtime, and summary. If you're pulling data for multiple shows, your script can loop through using `get_show_episodes` to generate a comprehensive guide file containing all episode details.

Aggregating Full Network Schedules

For CI/CD pipelines that need current scheduling info, run `get_schedule`. You specify the target country (e.g., 'US') and date ('YYYY-MM-DD'). This tool pulls every entry—show name, network, airtime, and episode details—for that specific day. This is critical for building scheduled content deployment checks. The output gives you a clean JSON array of all planned broadcast events.

Searching and Retrieving Show Metadata

Start by using `search_shows` to find show IDs, allowing your script to filter results based on genres or years. Once you have the ID, run `get_show`. This pulls all necessary metadata: rating, premiered date, summary, genres, and external IDs (IMDb). If you need absolute certainty on a title, use `single_search` instead; it's designed to return one result or none when matching specific show names.

Setup guide

Set up TVMaze MCP in Cline

Prerequisites

VS Code with Cline extension installed
Active Vinkius subscription with a valid endpoint token

1

Open Cline MCP settings

Click the Cline icon in the VS Code sidebar to open the Cline panel. Then click the MCP Servers icon (server stack) at the top-right corner of the panel.
2

Add a remote server

Click "Remote Servers" at the top, then click "Add Remote MCP". In the Name field, type tvmaze-mcp. In the URL field, paste your Vinkius endpoint: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp. Get your token from cloud.vinkius.com.
3

Enable the server

After saving, the server appears in the Cline MCP panel. Toggle the switch to enable it. The status indicator turns green when the connection is live.
4

Start using tools

Return to the Cline chat and ask: "Check my latest TVMaze refund status." Cline will discover the available tools and request your approval before invoking each one — giving you full control over every action.

Cline MCP Settings

{
  "mcpServers": {
    "tvmaze-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by TVMaze. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect TVMaze now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about TVMaze MCP in Cline

First, run `get_show` to get the show ID. Then, pipe that into `get_show_cast`. Your agent collects every actor’s name and character name linked directly to that series for your component build.

You should use `get_show_episodes`. It pulls season/episode numbers, air dates, summaries, and runtimes. You can easily adjust the script logic to include specials by setting the correct flag.

Yes, use `get_full_schedule`. It dumps every known future episode across all shows and networks. You just pass in the country code you want to restrict the results by.

No, the `single_search` tool is designed specifically so that you can get embedded details like episodes and cast without needing a separate API key. It makes scripting easier.

The server touches structured text data, including show names, episode summaries, character name strings, genres, and network information. This is perfect for building reliable content databases.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript