`search_movies`

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

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

Search for movies by title or keyword. Returns title, director, release date, genre, description, and artwork.

Parameters

Name	Type	Required	Description
`query`	string	yes	Movie title or keyword to search for
`limit`	number	no	Number of results to return (1-25, default 10)

Example call

Arguments

{
  "query": "Inception"
}

curl

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

TypeScript (@pipeworx/sdk)

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

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

More examples

{
  "query": "Christopher Nolan",
  "limit": 15
}

Response shape

Always returns: total_found, movies

Field	Type	Description
`total_found`	number	Total number of movies found
`movies`	array

Full JSON Schema

{
  "type": "object",
  "properties": {
    "total_found": {
      "type": "number",
      "description": "Total number of movies found"
    },
    "movies": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "title": {
            "type": [
              "string",
              "null"
            ],
            "description": "Movie title"
          },
          "director": {
            "type": [
              "string",
              "null"
            ],
            "description": "Director or artist name"
          },
          "release_date": {
            "type": [
              "string",
              "null"
            ],
            "description": "Release date in YYYY-MM-DD format"
          },
          "genre": {
            "type": [
              "string",
              "null"
            ],
            "description": "Primary genre"
          },
          "description": {
            "type": [
              "string",
              "null"
            ],
            "description": "Long or short description of the movie"
          },
          "rating": {
            "type": [
              "string",
              "null"
            ],
            "description": "Content advisory rating"
          },
          "runtime_minutes": {
            "type": [
              "number",
              "null"
            ],
            "description": "Runtime in minutes"
          },
          "itunes_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "iTunes store URL"
          },
          "artwork_url": {
            "type": [
              "string",
              "null"
            ],
            "description": "Artwork image URL"
          }
        },
        "required": [
          "title",
          "director",
          "release_date",
          "genre",
          "description",
          "rating",
          "runtime_minutes",
          "itunes_url",
          "artwork_url"
        ]
      }
    }
  },
  "required": [
    "total_found",
    "movies"
  ]
}

Connect

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

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

See Getting Started for client-specific install steps.

search_movies