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

Text search across TV shows.

Parameters

NameTypeDescription

queryreqstringShow name

▶Try it

Response

get_showrequired: show_id

Full show record with optional embeds (episodes / cast / seasons).

Parameters

NameTypeDescription

show_idreqnumberTVMaze show ID

embed_episodesoptbooleanInclude episodes

embed_castoptbooleanInclude cast

embed_seasonsoptbooleanInclude seasons

▶Try it

Response

list_episodesrequired: show_id

All episodes of a show.

Parameters

NameTypeDescription

show_idreqnumberTVMaze show ID

specialsoptbooleanInclude specials

▶Try it

Response

get_schedule

What's airing on a country/day.

Parameters

NameTypeDescription

countryoptstring2-letter country code (default US)

dateoptstringYYYY-MM-DD (default today)

▶Try it

Response

search_peoplerequired: query

Actors / people search.

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"
      ]
    }
  }
}