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
| Name | Type | Required | Description |
|---|---|---|---|
country | string | no | ISO alpha-2 (default us) |
limit | number | no | 1-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
| Field | Type | Description |
|---|---|---|
feed | object |
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.