top_movies

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

DEPRECATED, Apple discontinued the iTunes movies chart (permanent 404). For popular, trending, or current movies use the tmdb pack instead: tmdb_trending, discover_movie, or get_movie.

Parameters

NameTypeRequiredDescription
countrystringnoISO alpha-2 (default us)
limitnumberno1-100 (default 25)

Example call

Arguments

{
  "country": "us",
  "limit": 25
}

curl

curl -X POST https://gateway.pipeworx.io/itunes-search/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"top_movies","arguments":{"country":"us","limit":25}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('top_movies', {
  "country": "us",
  "limit": 25
});

Response shape

FieldTypeDescription
feedobject
Full JSON Schema
{
  "type": "object",
  "properties": {
    "feed": {
      "type": "object",
      "properties": {
        "title": {
          "type": "string",
          "description": "Feed title"
        },
        "id": {
          "type": "string",
          "description": "Feed ID"
        },
        "author": {
          "type": "object",
          "properties": {
            "name": {
              "type": "string",
              "description": "Author name"
            },
            "uri": {
              "type": "string",
              "description": "Author URI"
            }
          }
        },
        "links": {
          "type": "array",
          "description": "Feed links",
          "items": {
            "type": "object",
            "properties": {
              "rel": {
                "type": "string",
                "description": "Link relation"
              },
              "href": {
                "type": "string",
                "description": "Link URL"
              }
            }
          }
        },
        "copyright": {
          "type": "string",
          "description": "Copyright notice"
        },
        "updated": {
          "type": "string",
          "description": "Last update timestamp"
        },
        "results": {
          "type": "array",
          "description": "Array of top movies",
          "items": {
            "type": "object",
            "properties": {
              "artistName": {
                "type": "string",
                "description": "Movie title"
              },
              "id": {
                "type": "string",
                "description": "Movie ID"
              },
              "releaseDate": {
                "type": "string",
                "description": "Release date"
              },
              "name": {
                "type": "string",
                "description": "Movie name"
              },
              "kind": {
                "type": "string",
                "description": "Media kind"
              },
              "copyright": {
                "type": "string",
                "description": "Copyright info"
              },
              "contentAdvisoryRating": {
                "type": "string",
                "description": "Content rating"
              },
              "artworkUrl100": {
                "type": "string",
                "description": "100x100 artwork URL"
              },
              "genres": {
                "type": "array",
                "description": "Genre list",
                "items": {
                  "type": "object",
                  "properties": {
                    "genreId": {
                      "type": "string",
                      "description": "Genre ID"
                    },
                    "name": {
                      "type": "string",
                      "description": "Genre name"
                    },
                    "url": {
                      "type": "string",
                      "description": "Genre URL"
                    }
                  }
                }
              },
              "url": {
                "type": "string",
                "description": "iTunes URL"
              }
            }
          }
        }
      }
    }
  }
}

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 itunes-search pack
{
  "mcpServers": {
    "itunes-search": {
      "url": "https://gateway.pipeworx.io/itunes-search/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

Regenerated from source · build November 19, 2026