Tvmaze MCP
MCP server for searching TV shows and reading schedules from TVMaze
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"tvmaze-mcp": {
"command": "npx",
"args": [
"-y",
"tvmaze-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tvmaze-mcp": {
"command": "npx",
"args": [
"-y",
"tvmaze-mcp"
]
}
}
}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.