Skip to content
MCP server

Tvmaze MCP

MCP server for searching TV shows and reading schedules from TVMaze

Runs locally
Install
Pricing
Open source
Platforms
CLI, API
Runs
Locally
Version
1.0.0
Listing updated
today

Similar MCP servers

About Tvmaze MCP

Tvmaze MCP is an open-source MCP server for tv and radio guides. It runs locally on your machine and is started by your AI client.

The registry entry describes this as a TVMaze show search and schedule server. It is published as an npm package named tvmaze-mcp and runs over stdio, so an MCP client launches it locally and calls its tools directly. No environment variables are declared in the registry entry.

The server is one of many small servers in the awesome-servers repository, which the README says wrap a single keyless public dataset each. The README does not list the specific tools this server exposes, so the details of its search and schedule queries are not described here.

It suits developers and assistant users who want an AI client to look up TV shows or upcoming episodes from TVMaze data.

Install

Run in a terminal

claude mcp add tvmaze-mcp -- npx -y tvmaze-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tvmaze-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tvmaze-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tvmaze-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tvmaze-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "tvmaze-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "tvmaze-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "tvmaze-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tvmaze-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "tvmaze-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "tvmaze-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

What it does

Show search
Looks up TV shows by name through the TVMaze data source.
Episode schedules
Returns TV listings and schedule information for the TVMaze catalogue.
Local stdio transport
Runs as a local process over stdio, launched by an MCP client via npm.
No setup variables
The registry entry declares no environment variables to configure.

Good for

  • Asking an AI assistant which shows match a given title
  • Checking upcoming TV schedules from within an MCP-enabled client
  • Building a small TV guide feature on top of MCP tool calls

Pricing

Open source

Free, runs locally from an npm package.

Tvmaze MCP FAQ

How is the server installed?

The registry lists it as an npm package, tvmaze-mcp, version 1.0.0, run over the stdio transport.

Does it need an API key?

The registry entry declares no environment variables, so no key is listed there.

Is Tvmaze MCP free?

Yes. Tvmaze MCP is open source, so you can use and self-host it for free.

How do I add Tvmaze MCP to Claude Code?

Run this command in your terminal: claude mcp add tvmaze-mcp -- npx -y tvmaze-mcp

What are the best alternatives to Tvmaze MCP?

The closest alternatives to Tvmaze MCP are Tv Maze Mcp and TMDB MCP Server.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers