`search_titles`

Pack: omdb · 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/search_titles for the schema, then POST the same URL with its arguments for the data.

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 — 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 omdb pack

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

See Getting Started for client-specific install steps.

search_titles