`discover_movie`

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

Discover TMDB movies using advanced filters passed as query params (genre, year, certification, vote average, sort order, etc.). Use genres_movie to get valid genre IDs first.

Example call

Arguments

{
  "sort_by": "popularity.desc",
  "with_genres": "28"
}

curl

curl -X POST https://gateway.pipeworx.io/tmdb/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"discover_movie","arguments":{"sort_by":"popularity.desc","with_genres":"28"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('discover_movie', {
  "sort_by": "popularity.desc",
  "with_genres": "28"
});

More examples

{
  "primary_release_year": 2023,
  "vote_average.gte": 7
}

Response shape

Field	Type	Description
`page`	number	Current page number
`results`	array	Discovered movies
`total_pages`	number	Total pages
`total_results`	number	Total results

Full JSON Schema

{
  "type": "object",
  "properties": {
    "page": {
      "type": "number",
      "description": "Current page number"
    },
    "results": {
      "type": "array",
      "description": "Discovered movies",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number"
          },
          "title": {
            "type": "string"
          }
        }
      }
    },
    "total_pages": {
      "type": "number",
      "description": "Total pages"
    },
    "total_results": {
      "type": "number",
      "description": "Total 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 tmdb pack

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

See Getting Started for client-specific install steps.

discover_movie