Epguides API

REST API for TV show data, episode lists, air dates, and plot summaries. Includes an MCP server for AI assistant integration.

Links

Resource	URL
Public API	https://epguides.frecar.no
Swagger UI	https://epguides.frecar.no/docs
Documentation	https://epguides-api.readthedocs.io
MCP Endpoint	https://epguides.frecar.no/mcp

Features

• TV show database with metadata for thousands of series
• Search shows by title
• Browse seasons and episodes
• Plot summaries via TVMaze
• Show posters, season posters, episode stills
• Next/latest episode tracking
• Natural language search (LLM-powered)
• MCP server for AI assistants

Quick Start

No API key needed:

# Search for shows
curl "https://epguides.frecar.no/shows/search?query=breaking+bad"

# Get show details
curl "https://epguides.frecar.no/shows/BreakingBad"

# List seasons
curl "https://epguides.frecar.no/shows/BreakingBad/seasons"

# Get episodes for a season
curl "https://epguides.frecar.no/shows/BreakingBad/seasons/1/episodes"

# Get all episodes with filtering
curl "https://epguides.frecar.no/shows/BreakingBad/episodes?season=5"

# Get next episode
curl "https://epguides.frecar.no/shows/Severance/episodes/next"

Documentation

Full docs at epguides-api.readthedocs.io:

• Getting Started
• REST API Reference
• MCP Server
• Configuration
• Development

Self-Hosting

Development

git clone https://github.com/frecar/epguides-api.git
cd epguides-api
make setup
make up

# API at http://localhost:3000 (with hot reload)

Production

make up-prod

# 12 workers, uvloop, 5GB Redis cache

See Development Guide for details.

Data Sources

Source	Data
epguides.com	Show catalog, episode lists, air dates
TVMaze	Summaries, posters, episode stills
IMDB	IMDB IDs

License

MIT