tvschedule.org
Sign in Get a free key
API Docs / More

MCP tools

Every tool the MCP server offers, and the endpoint behind it.

Each tool is one endpoint, with the same parameters (lists start at the first page). The plan each needs is the endpoint's.

check_usage

Your plan, calls today and this month, limits and the data window. Not counted.

GET /v1/usage

list_countries

Every country with listings, its channel count and programmes today.

GET /v1/countries

country_channels

Every channel in a country, with ids, names and categories.

  • cc required Country code, two letters, such as gb or us.
  • limit How many to return.
GET /v1/countries/{cc}/channels

find_channel

Find a channel by name, alias or call sign.

  • q required Channel name, alias or call sign to look for.
  • country Only this country: a two-letter code, such as gb.
  • limit How many to return.
GET /v1/channels/search/{q}

get_channel

One channel: names, country, languages, categories and launch year.

  • id required Channel id, from find_channel or country_channels.
GET /v1/channels/{id}

channel_schedule

A channel's day, slot by slot, times in UTC. The date is YYYY-MM-DD, yesterday, today or tomorrow.

  • id required Channel id, from find_channel or country_channels.
  • date required The day: YYYY-MM-DD, yesterday, today or tomorrow.
  • tz Show times in this time zone, such as Europe/London. Times are UTC without it.
GET /v1/channels/{id}/schedule/{date}

country_schedule

Every channel in a country for a day, 50 channels a page. Live and Complete plans.

  • cc required Country code, two letters, such as gb or us.
  • date required The day: YYYY-MM-DD, yesterday, today or tomorrow.
  • tz Show times in this time zone, such as Europe/London. Times are UTC without it.
GET /v1/countries/{cc}/schedule/{date}

find_show

Find a show by any of its titles. Live and Complete plans; the free key gets an empty answer with a note.

  • q required Any title of the show.
  • limit How many to return.
GET /v1/shows/search/{q}

get_show

One show: titles, network, genres, status and premiere. Live and Complete plans; the free key gets an empty answer with a note.

  • id required Show id, from find_show.
GET /v1/shows/{id}

show_airings

Where and when a show airs in the days ahead, first runs and repeats. Live and Complete plans; the free key gets an empty answer with a note.

  • id required Show id, from find_show.
  • country Only this country: a two-letter code, such as gb.
  • days How many days ahead to cover.
GET /v1/shows/{id}/airings

show_pattern

A show's usual slot, its day by hour fingerprint and repeat share. Live and Complete plans; the free key gets an empty answer with a note.

  • id required Show id, from find_show.
GET /v1/shows/{id}/pattern

show_stats

Airing counts by channel, country and year, first and last aired. Live and Complete plans; the free key gets an empty answer with a note.

  • id required Show id, from find_show.
GET /v1/shows/{id}/stats

channel_stats

Days held, programmes a week, genre mix and repeat share for a channel. Live and Complete plans; the free key gets an empty answer with a note.

  • id required Channel id, from find_channel or country_channels.
GET /v1/channels/{id}/stats

most_aired

The most aired shows and films in a country last week, with the change. Live and Complete plans.

  • cc required Country code, two letters, such as gb or us.
  • limit How many to return.
GET /v1/countries/{cc}/most-aired

repeats

The most repeated shows and films in a country last week. Live and Complete plans.

  • cc required Country code, two letters, such as gb or us.
  • limit How many to return.
GET /v1/countries/{cc}/repeats
PreviousYour usage NextChangelog