• DATA
  • VISUALS
  • EPISODES
  • HUMAN

How to lookup TV show metadata with your AI

Connect TVMaze to your AI client to turn any chat interface into a television database. Once connected, your agent handles the data fetching for you.

Ask AI about this page

Short answer

How can I get TV show info using my AI?

Your AI uses the TVMaze MCP to search for series, pull specific episode data, and grab show posters. You get instant access to ratings, summaries, and status updates through your existing chat window.

The results you get.

What your AI delivers.

The data your agent pulls from TVMaze.

DATA

Series intelligence

The AI finds show statuses, genre info, and summaries. You get the facts without searching a browser.

VISUALS

Show posters

Your agent fetches image assets and posters for any series. This makes your chat interface more visual.

EPISODES

Detailed episode logs

Get specific details on individual episodes, including air dates and plot points. It's perfect for deep dives.

HUMAN

Manual verification

You decide if the metadata is relevant to your project. The AI provides the data, but you make the final call.

The workflow

What your AI does when you ask about a show.

The AI follows a logical path to find the exact data you need.

  1. Find the show

    The agent starts by searching for the correct series title to get a unique ID.

    search_shows

  2. Pull series details

    Once the ID is found, the AI grabs the full profile, including status and ratings.

    get_show

  3. Fetch episode info

    If you ask about a specific part of the series, the AI looks up that episode's data.

    get_episode

  4. Grab posters

    The agent pulls visual assets like posters to accompany the text data.

    get_show_images

Try it

Copy these to start.

Use these prompts to trigger the TVMaze tools.

Starting points

Replace the show names in these examples with whatever you want to look up.

TVMaze Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_LDpJkwhpFfwwhfOomQaw5hAp2UEphl7LFZF5rSpw/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — TVMaze capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "tvmaze-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_LDpJkwhpFfwwhfOomQaw5hAp2UEphl7LFZF5rSpw/mcp"
    }
  }
}
Copy into chat04

  • Search for the show 'The Bear' and tell me its current status.

  • Find the poster for the series 'Succession'.

  • What happened in the first episode of 'Severance'?

  • Give me a summary and the rating for 'Shogun'.

  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Start here

Connect TVMaze once, then ask.

Click the link to connect the MCP to your client. Your credentials stay encrypted, and you can start querying immediately.

Connect TVMaze to your AI

FAQ

Common questions

  • 01

    Can the AI update show information on TVMaze?

    No. The tools only allow the AI to read data from TVMaze, not change it.

  • 02

    Can I use this to watch shows?

    No. This MCP is for retrieving metadata and images, not for streaming video.

  • 03

    Does the AI know if a show is currently airing?

    Yes, it can check the series status through the show details.

  • 04

    Can the AI delete my chat history?

    No. The AI only interacts with the TVMaze API; it has no control over your chat client's history.

  • 05

    Will the AI find images for every single show?

    It will attempt to find images, but it depends on what assets are available in the TVMaze database.

  • More questions about TVMaze? See everything the TVMaze Connector can do

Connect TVMaze to Claude, Cursor, ChatGPT & more