`films`

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

List all Studio Ghibli films (up to optional limit), returning title, director, producer, release year, running time, Rotten Tomatoes score, and related character/location/vehicle URLs.

Parameters

Name	Type	Required	Description
`limit`	number	no

Example call

Arguments

{
  "limit": 10
}

curl

curl -X POST https://gateway.pipeworx.io/studio-ghibli/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"films","arguments":{"limit":10}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('films', {
  "limit": 10
});

More examples

{}

Response shape

Always returns: items, count

Field	Type	Description
`items`	array
`count`	integer	Number of items returned.

Full JSON Schema

{
  "type": "object",
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Film unique identifier"
          },
          "title": {
            "type": "string",
            "description": "Film title"
          },
          "original_title": {
            "type": "string",
            "description": "Original Japanese title"
          },
          "original_title_romanised": {
            "type": "string",
            "description": "Romanized original title"
          },
          "description": {
            "type": "string",
            "description": "Film description"
          },
          "director": {
            "type": "string",
            "description": "Film director name"
          },
          "producer": {
            "type": "string",
            "description": "Film producer name"
          },
          "release_date": {
            "type": "string",
            "description": "Release date"
          },
          "running_time": {
            "type": "string",
            "description": "Running time in minutes"
          },
          "rt_score": {
            "type": "string",
            "description": "Rotten Tomatoes score"
          },
          "people": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Array of people IDs"
          },
          "species": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Array of species IDs"
          },
          "locations": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Array of location IDs"
          },
          "vehicles": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Array of vehicle IDs"
          },
          "url": {
            "type": "string",
            "description": "API URL for this film"
          }
        }
      }
    },
    "count": {
      "type": "integer",
      "description": "Number of items returned."
    }
  },
  "required": [
    "items",
    "count"
  ]
}

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 studio-ghibli pack

{
  "mcpServers": {
    "studio-ghibli": {
      "url": "https://gateway.pipeworx.io/studio-ghibli/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

films