`imdb_get_title`

Pack: imdb · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/imdb_get_title for the schema, then POST the same URL with its arguments for the data.

Full detail for one IMDB title by tconst id (e.g. “tt0111161”). Returns title, year, runtime, genres, plus rating (average + votes) and crew (directors/writers as nconst arrays).

Parameters

Name	Type	Required	Description
`imdb_id`	string	yes	tconst, e.g. “tt0111161”

Example call

Arguments

{
  "imdb_id": "tt0111161"
}

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_get_title","arguments":{"imdb_id":"tt0111161"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('imdb_get_title', {
  "imdb_id": "tt0111161"
});

More examples

{
  "imdb_id": "tt0903747"
}

Response shape

Full JSON Schema

{
  "oneOf": [
    {
      "type": "object",
      "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"
        }
      },
      "required": [
        "imdb_id",
        "title",
        "title_type",
        "is_adult",
        "start_year",
        "end_year",
        "runtime_minutes",
        "genres",
        "rating",
        "crew",
        "url"
      ]
    },
    {
      "type": "object",
      "properties": {
        "error": {
          "type": "string",
          "enum": [
            "not_found"
          ],
          "description": "Error code"
        },
        "message": {
          "type": "string",
          "description": "Error message"
        }
      },
      "required": [
        "error",
        "message"
      ]
    }
  ]
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

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

Connect to just the imdb pack

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

See Getting Started for client-specific install steps.

imdb_get_title