MCP server
Tvmaze MCP Server
TVmaze shows, people, next episodes in your timezone, episode guides, schedules, and…
- Pricing
- Open source
- Runs
- Locally or Remotely
- Version
- 0.4.0
- Listing updated
- 4 days ago
About Tvmaze MCP Server
Tvmaze MCP Server is an open-source MCP server. It can run locally on your machine or as a hosted remote server.
TVmaze shows, people, next episodes in your timezone, episode guides, schedules, and credits.
Install
Run in a terminal
claude mcp add --transport http tvmaze-mcp-server https://tvmaze.caseyjhand.com/mcpAdd to Settings → Connectors → Add custom connector
https://tvmaze.caseyjhand.com/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tvmaze-mcp-server": {
"url": "https://tvmaze.caseyjhand.com/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-server": {
"type": "http",
"url": "https://tvmaze.caseyjhand.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tvmaze-mcp-server": {
"serverUrl": "https://tvmaze.caseyjhand.com/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tvmaze-mcp-server": {
"type": "http",
"url": "https://tvmaze.caseyjhand.com/mcp"
}
}
}Configuration
TVMAZE_BASE_URLTVmaze API base URL. Override to point at an enterprise endpoint.TVMAZE_USER_AGENTUser-Agent sent on every upstream request. TVmaze asks that clients identify themselves. Defaults to the server name, version, and repository URL.TVMAZE_DEFAULT_TIMEZONEIANA timezone used when a tool call omits 'timezone' (e.g. 'America/Los_Angeles').TVMAZE_DEFAULT_COUNTRYISO 3166-1 alpha-2 country used for tvmaze_get_schedule scopes 'linear' and 'all' when 'country' is omitted.TVMAZE_CACHE_TTL_SSeconds to hold an upstream response in the in-process cache. 0 disables caching.TVMAZE_MAX_CONCURRENCYConcurrent upstream requests.TVMAZE_REQUEST_TIMEOUT_MSPer-request timeout in milliseconds.MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').MCP_TRANSPORT_TYPESelects the HTTP transport.TVMAZE_BASE_URLTVmaze API base URL. Override to point at an enterprise endpoint.TVMAZE_USER_AGENTUser-Agent sent on every upstream request. TVmaze asks that clients identify themselves. Defaults to the server name, version, and repository URL.TVMAZE_DEFAULT_TIMEZONEIANA timezone used when a tool call omits 'timezone' (e.g. 'America/Los_Angeles').TVMAZE_DEFAULT_COUNTRYISO 3166-1 alpha-2 country used for tvmaze_get_schedule scopes 'linear' and 'all' when 'country' is omitted.TVMAZE_CACHE_TTL_SSeconds to hold an upstream response in the in-process cache. 0 disables caching.TVMAZE_MAX_CONCURRENCYConcurrent upstream requests.TVMAZE_REQUEST_TIMEOUT_MSPer-request timeout in milliseconds.MCP_HTTP_HOSTThe hostname for the HTTP server.MCP_HTTP_PORTThe port to run the HTTP server on.MCP_HTTP_ENDPOINT_PATHThe endpoint path for the MCP server.MCP_AUTH_MODEAuthentication mode to use: 'none', 'jwt', or 'oauth'.MCP_LOG_LEVELSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
Pricing
Open source
Tvmaze MCP Server FAQ
Is Tvmaze MCP Server free?
Yes. Tvmaze MCP Server is open source, so you can use and self-host it for free.
How do I add Tvmaze MCP Server to Claude Code?
Run this command in your terminal: claude mcp add --transport http tvmaze-mcp-server https://tvmaze.caseyjhand.com/mcp