Epguides API

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

🔗 Links

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

✨ Features

• 📺 TV Show Database — Metadata for thousands of TV series
• 🔍 Search — Find shows by title
• 📅 Episode Data — Full episode lists with air dates
• 📝 Plot Summaries — Episode descriptions via TVMaze
• ⏭️ Episode Tracking — Get next/latest episodes
• 🤖 AI Search — Natural language queries (LLM-powered)
• 🔌 MCP Server — JSON-RPC for AI assistants

🚀 Quick Start

No API key needed. Just start making requests:

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

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

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

# Filter by season
curl "https://epguides.frecar.no/shows/BreakingBad/episodes?season=5"

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

📖 Documentation

Full documentation at epguides-api.readthedocs.io:

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

🛠️ Self-Hosting

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

# API running at http://localhost:3000

📊 Data Sources

Source	Data
epguides.com	Show catalog, episode lists, air dates
TVMaze	Episode summaries
IMDB	IMDB IDs

📄 License

MIT — see LICENSE