71.8M listings
Every country's schedule under one key, one shape and one set of ids.
GET /v1/now
What every channel in a country is showing this minute, with the next programme after it.
MIT, no lock-in
Every lab tool reads only the public API with your own key, so it runs on the free key.
Working normally
Checked every minute from outside our own servers.
Plug the TV Guide API into Claude, ChatGPT, Cursor or any assistant that speaks the Model Context Protocol. 12 tools for schedules, now and next, shows, episodes and live sport in 155 countries, on your own key, with the free key included.
One address and your key as a bearer token. If this browser remembered your key in the documentation, it is filled in below already.
# Claude Code: one line, then ask in plain words claude mcp add --transport http tvguideapi https://tvguideapi.com/mcp \ --header "Authorization: Bearer YOUR_KEY"
// Cursor (~/.cursor/mcp.json), VS Code and other clients that read an mcpServers file { "mcpServers": { "tvguideapi": { "type": "http", "url": "https://tvguideapi.com/mcp", "headers": { "Authorization": "Bearer YOUR_KEY" } } } }
// any MCP client: Streamable HTTP, JSON-RPC 2.0 URL https://tvguideapi.com/mcp Header Authorization: Bearer YOUR_KEY Tools tools/list, then tools/call // one tool call counts as one API call, on your plan's limits
# test it from a terminal: the tools it offers curl -s https://tvguideapi.com/mcp \ -H "Authorization: Bearer YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Each tool is an API endpoint with the same data, limits and counting. The assistant chooses; you just ask.
Plain words in, an answer from the live guide out. Several tools in a row when a question needs it.
The free key answers schedules, now and next, channels and shows. Sport, episodes and the archive come with the paid plans.
A free key in a minute, with Google. No card. 12 tools, 41,066 channels, 155 countries.