`search_tv_shows`

Pack: movies · Endpoint: https://gateway.pipeworx.io/movies/mcp

Look up a TV SERIES BY NAME on TVmaze and get its facts in one call — “tell me about the TV show Breaking Bad”, “when did The Sopranos air”, “how was Chernobyl rated”, “what network was Mad Men on”, “is The Bear still running”. Returns the show name, genres, premiere and end dates, status (Running/Ended), rating, network, summary and images for each match. THE entry point for a named series: it takes the TITLE directly, so a show known by name is answered here without resolving an id first.

Parameters

Name	Type	Required	Description
`query`	string	yes	TV show name or keyword to search for

Example call

Arguments

{
  "query": "Breaking Bad"
}

curl

curl -X POST https://gateway.pipeworx.io/movies/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_tv_shows","arguments":{"query":"Breaking Bad"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search_tv_shows', {
  "query": "Breaking Bad"
});

More examples

{
  "query": "sci-fi drama"
}

Response shape

Always returns: total_found, shows

Field	Type	Description
`total_found`	number	Total number of shows found
`shows`	array

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total_found": {
      "type": "number",
      "description": "Total number of shows found"
    },
    "shows": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "score": {
            "type": "number",
            "description": "Search relevance score"
          },
          "id": {
            "type": "number",
            "description": "TVmaze show ID"
          },
          "name": {
            "type": "string",
            "description": "Show name"
          },
          "type": {
            "type": [
              "string",
              "null"
            ],
            "description": "Show type (e.g., Scripted, Reality)"
          },
          "language": {
            "type": [
              "string",
              "null"
            ],
            "description": "Primary language"
          },
          "genres": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "List of genres"
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Current status (Running, Ended, etc.)"
          },
          "premiered": {
            "type": [
              "string",
              "null"
            ],
            "description": "Premiere date in YYYY-MM-DD format"
          },
          "ended": {
            "type": [
              "string",
              "null"
            ],
            "description": "End date in YYYY-MM-DD format"
          },
          "rating": {
            "type": [
              "number",
              "null"
            ],
            "description": "Average rating score"
          },
          "network": {
            "type": [
              "string",
              "null"
            ],
            "description": "Network or web channel name"
          },
          "summary": {
            "type": [
              "string",
              "null"
            ],
            "description": "Show summary without HTML tags"
          },
          "url": {
            "type": [
              "string",
              "null"
            ],
            "description": "TVmaze show URL"
          },
          "image": {
            "type": [
              "string",
              "null"
            ],
            "description": "Medium-size poster image URL"
          }
        },
        "required": [
          "score",
          "id",
          "name",
          "type",
          "language",
          "genres",
          "status",
          "premiered",
          "ended",
          "rating",
          "network",
          "summary",
          "url",
          "image"
        ]
      }
    }
  },
  "required": [
    "total_found",
    "shows"
  ]
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "movies": {
      "url": "https://gateway.pipeworx.io/movies/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search_tv_shows