imdb_episodes
Pack: imdb · Endpoint: https://gateway.pipeworx.io/imdb/mcp
List every episode for a TV series, in season/episode order. Returns parent series detail plus episode list with title and rating per episode.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
series_id | string | yes | Series tconst, e.g. “tt0903747” (Breaking Bad) |
season | number | no | Optional: filter to one season |
limit | number | no | Max episodes returned (default 500, max 2000) |
Example call
Arguments
{
"series_id": "tt0903747"
}curl
curl -X POST https://gateway.pipeworx.io/imdb/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"imdb_episodes","arguments":{"series_id":"tt0903747"}}}'TypeScript (@pipeworx/sdk)
import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();
const result = await pipeworx.call('imdb_episodes', {
"series_id": "tt0903747"
});More examples
{
"series_id": "tt0903747",
"season": 5,
"limit": 100
}Response shape
Full JSON Schema
{
"oneOf": [
{
"type": "object",
"properties": {
"series": {
"type": "object",
"description": "Parent series details",
"properties": {
"imdb_id": {
"type": "string",
"description": "IMDB title ID (tconst)"
},
"title": {
"type": [
"string",
"null"
],
"description": "Primary title"
},
"original_title": {
"type": [
"string",
"null"
],
"description": "Original title if different from primary"
},
"title_type": {
"type": [
"string",
"null"
],
"description": "Type: movie, tvSeries, tvMiniSeries"
},
"is_adult": {
"type": [
"boolean",
"null"
],
"description": "Adult content flag"
},
"start_year": {
"type": [
"number",
"null"
],
"description": "Release year"
},
"end_year": {
"type": [
"number",
"null"
],
"description": "End year for TV series"
},
"runtime_minutes": {
"type": [
"number",
"null"
],
"description": "Runtime in minutes"
},
"genres": {
"type": "array",
"description": "Genre tags",
"items": {
"type": "string"
}
},
"rating": {
"type": [
"object",
"null"
],
"description": "Rating data",
"properties": {
"average": {
"type": [
"number",
"null"
],
"description": "Average rating (0-10)"
},
"votes": {
"type": [
"number",
"null"
],
"description": "Number of votes"
}
}
},
"crew": {
"type": [
"object",
"null"
],
"description": "Director and writer info",
"properties": {
"directors": {
"type": "array",
"description": "Director nconsts",
"items": {
"type": "string"
}
},
"writers": {
"type": "array",
"description": "Writer nconsts",
"items": {
"type": "string"
}
}
}
},
"url": {
"type": "string",
"description": "IMDB title URL"
}
}
},
"season_filter": {
"type": [
"number",
"null"
],
"description": "Season filter applied if any"
},
"episode_count": {
"type": "number",
"description": "Number of episodes returned"
},
"episodes": {
"type": "array",
"description": "List of episodes",
"items": {
"type": "object",
"properties": {
"imdb_id": {
"type": "string",
"description": "Episode IMDB ID (tconst)"
},
"season": {
"type": [
"number",
"null"
],
"description": "Season number"
},
"episode": {
"type": [
"number",
"null"
],
"description": "Episode number within season"
},
"title": {
"type": [
"string",
"null"
],
"description": "Episode title"
},
"rating": {
"type": [
"object",
"null"
],
"description": "Episode rating",
"properties": {
"average": {
"type": [
"number",
"null"
],
"description": "Average rating (0-10)"
},
"votes": {
"type": [
"number",
"null"
],
"description": "Number of votes"
}
}
},
"url": {
"type": "string",
"description": "Episode IMDB URL"
}
}
}
}
},
"required": [
"series",
"season_filter",
"episode_count",
"episodes"
]
},
{
"type": "object",
"properties": {
"error": {
"type": "string",
"enum": [
"not_found"
],
"description": "Error code"
},
"message": {
"type": "string",
"description": "Error message"
},
"series": {
"type": [
"object",
"null"
],
"description": "Series data if found, null otherwise",
"properties": {
"imdb_id": {
"type": "string",
"description": "IMDB title ID (tconst)"
},
"title": {
"type": [
"string",
"null"
],
"description": "Primary title"
}
}
}
},
"required": [
"error",
"message"
]
}
]
}Connect
Add this to your MCP client config, or use one-click install buttons:
{
"mcpServers": {
"imdb": {
"url": "https://gateway.pipeworx.io/imdb/mcp"
}
}
}See Getting Started for client-specific install steps.