TVMaze

liveFilm/TVEntertainmentMedia

TV show metadata, episode schedules, cast. Complements the movies pack with TV-specific coverage.

5tools

0msauth

free tier50 calls/day

Tools

search_showsrequired: query

Search TV shows by name. Returns shows with id, name, premiere date, network, genres, rating, status, and TVMaze URL.

Parameters

NameTypeDescription

queryreqstringShow name

▶Try it

Response

get_showrequired: show_id

Fetch a full show record by TVMaze ID. Optionally embed episodes, cast, seasons, or previous/next episode info for richer responses.

Parameters

NameTypeDescription

show_idreqnumberTVMaze show ID

embed_episodesoptbooleanInclude episodes

embed_castoptbooleanInclude cast

embed_seasonsoptbooleanInclude seasons

▶Try it

Response

list_episodesrequired: show_id

List all episodes of a show. Returns season, number, name, airdate, runtime, and summary.

Parameters

NameTypeDescription

show_idreqnumberTVMaze show ID

specialsoptbooleanInclude specials

▶Try it

Response

get_schedule

What TV shows are airing on a given day in a country. Useful for "what aired last night on UK TV". Returns episode + show records.

Parameters

NameTypeDescription

countryoptstring2-letter country code (default US)

dateoptstringYYYY-MM-DD (default today)

▶Try it

Response

search_peoplerequired: query

Search TVMaze's actor/person database by name. Returns matched people with id, name, country code, birthday, deathday, gender, and headshot image URL.

Parameters

NameTypeDescription

queryreqstringPerson name

▶Try it

Response

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools

bash

curl -X POST https://gateway.pipeworx.io/tvmaze/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Call a tool

bash

curl -X POST https://gateway.pipeworx.io/tvmaze/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search_shows","arguments":{"query": "hello"}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript

import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("search_shows", {"query":"example"});

ask_pipeworx

// Or ask in plain English:
const answer = await px.ask("tv show metadata, episode schedules, cast");

Related packs

Other Pipeworx packs in the same categories (Film/TV, Entertainment, Media):

MCP Config

claude_desktop_config.json

{
  "mcpServers": {
    "pipeworx-tvmaze": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://gateway.pipeworx.io/tvmaze/mcp"
      ]
    }
  }
}