How to Use the TVMaze MCP in CrewAI

Q: How do I find a show using TVMaze and CrewAI?

Run searchshows first to identify potential titles. If you want maximum precision, use the single-shot singlesearch. The result package contains everything from episodes to cast info, which your crew can process immediately.

Q: Can I get both cast and crew details using TVMaze and CrewAI?

Yes. Use getshowcast for the actors, but also use getshowcrew to find key production staff like directors or creators. This allows your autonomous agents to build a complete team profile for any show.

Q: Does the TVMaze MCP Server support searching people by name?

You can use searchpeople, which uses fuzzy matching to find actors and crew members, even if you misspell their names. The results include notable shows for quick context.

Automate TV research with CrewAI running off the powerful TVMaze MCP Server.

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 CrewAI

Create your Vinkius account to connect TVMaze to CrewAI 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 CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Autonomous Show Research using CrewAI

Need a full dossier on a new show? First, Agent A uses `get_show` to grab all core details—genre, rating, summary. Then, Agent B takes the resulting ID and runs `get_show_episodes` to pull every season's episode guide. The crew collaboration makes this complex sequence easy. It even provides images for each season via `get_show_seasons`, letting your monitor agent build a complete visual report.

Cross-Reference People with CrewAI

Finding someone's career scope is simple. Agent A can use `get_person` to gather bio and external IDs for an actor. Then, Agent B uses `get_person_cast_credits` to list every show they were in, noting if the role was main or recurring. This makes building a complete resume possible. It's perfect for having one specialized agent research and another synthesize that data.

Schedule Analysis with CrewAI

Running a full market analysis? The `get_full_schedule` tool pulls all future episodes, allowing your crew to assess content availability across multiple networks. Because the MCP Server handles this large response, your autonomous agents don't choke on the data. Furthermore, you can use `get_show` and its external IDs in conjunction with the full schedule results for deeper context.

Setup guide

Set up TVMaze MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke TVMaze tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="TVMaze Analyst",
    goal="Access and analyze TVMaze data via MCP.",
    backstory="Expert analyst with direct TVMaze access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent TVMaze transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="TVMaze Analyst",
        goal="Access and analyze TVMaze data via MCP.",
        backstory="Expert analyst with direct TVMaze access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent TVMaze transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

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 CrewAI

Run `search_shows` first to identify potential titles. If you want maximum precision, use the single-shot `single_search`. The result package contains everything from episodes to cast info, which your crew can process immediately.

Yes. Use `get_show_cast` for the actors, but also use `get_show_crew` to find key production staff like directors or creators. This allows your autonomous agents to build a complete team profile for any show.

You can use `search_people`, which uses fuzzy matching to find actors and crew members, even if you misspell their names. The results include notable shows for quick context.

Episode information includes the season/number, air date, name, summary, runtime, and image URL via `get_show_episodes`. This is all the detail needed to write a comprehensive episode guide.

This MCP Server touches public biographical data for people (name, birthday, birthplace) and show details. The tools are read-only, so no private user accounts or sensitive data is ever involved.

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