`search_titles`

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

Keyword search across OMDb movies, series, and episodes. Returns up to 10 results per page with title, year, IMDB ID, type (movie/series/episode), and poster URL. Filter by release year or type.

Parameters

Name	Type	Required	Description
`query`	string	yes	Title keyword
`year`	number	no	Restrict to a release year
`type`	string	no	movie \| series \| episode
`page`	number	no	1-100 (default 1)

Example call

Arguments

{
  "query": "Inception"
}

curl

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

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('search_titles', {
  "query": "Inception"
});

More examples

{
  "query": "Breaking Bad",
  "type": "series",
  "year": 2008,
  "page": 1
}

Response shape

Always returns: query, total, returned, results

Field	Type	Description
`query`	string	The search query keyword
`total`	number	Total number of results available
`returned`	number	Number of results returned in this response
`results`	array	Array of search results (up to 10 per page)

Full JSON Schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "The search query keyword"
    },
    "total": {
      "type": "number",
      "description": "Total number of results available"
    },
    "returned": {
      "type": "number",
      "description": "Number of results returned in this response"
    },
    "results": {
      "type": "array",
      "description": "Array of search results (up to 10 per page)",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Movie/series/episode title"
          },
          "year": {
            "type": [
              "string",
              "null"
            ],
            "description": "Release year"
          },
          "imdb_id": {
            "type": [
              "string",
              "null"
            ],
            "description": "IMDB ID (tt-prefixed)"
          },
          "type": {
            "type": [
              "string",
              "null"
            ],
            "description": "Type: movie, series, or episode"
          },
          "poster": {
            "type": [
              "string",
              "null"
            ],
            "description": "Poster image URL or null if unavailable"
          }
        }
      }
    }
  },
  "required": [
    "query",
    "total",
    "returned",
    "results"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

search_titles