# Tvmaze MCP

> Tvmaze MCP is an open-source MCP server for tv and radio guides. MCP server for searching TV shows and reading schedules from TVMaze. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API
- **Repository:** https://github.com/mrfentmen/awesome-mcps
- **MCP Registry name:** io.github.mrfentmen/tvmaze-mcp
- **Categories:** [tv and radio guides](https://ai-powered.com/categories/tv-and-radio-guides)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add tvmaze-mcp -- npx -y tvmaze-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "tvmaze-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "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.

## Alternatives

- [Tv Maze Mcp](https://ai-powered.com/mcp/tv-maze-mcp): Tv Maze Mcp is a freemium MCP server for events and entertainment.
- [TMDB MCP Server](https://ai-powered.com/mcp/tmdb-mcp-server): TMDB MCP Server is an open-source MCP server for events and entertainment.

---
Source: https://ai-powered.com/mcp/tvmaze-mcp
