iTunes Search
liveMediaEntertainmentApple iTunes Store catalog search — music, movies, podcasts, audiobooks, ebooks, apps. Keyless.
Tools
searchrequired: termSearch the Apple iTunes catalog by keyword across music, movies, podcasts, TV shows, apps, ebooks, and more; filterable by media type, entity, country, and explicit flag; returns up to 200 matching it
termreqstring—mediaoptstring—entityoptstring—attributeoptstring—countryoptstring—limitoptnumber—langoptstring—explicitoptstring—Try it
lookupExact-ID lookup. Provide any one of id / bundle_id / isbn / upc / amg_artist_id / amg_album_id.
idoptstring—bundle_idoptstring—isbnoptstring—upcoptstring—amg_artist_idoptstring—amg_album_idoptstring—countryoptstring—entityoptstring—limitoptnumber—Try it
top_moviesDEPRECATED — 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.
countryoptstring—limitoptnumber—Try it
top_podcastsApple Podcasts chart, read from Apple's RSS Marketing Tools feed — the top-ranked shows in one storefront country (default us), up to 100 entries. Each entry returns the show name, publisher, Apple id
countryoptstring—limitoptnumber—Try it
top_booksApple Books chart, read from Apple's RSS Marketing Tools feed — the top-free (default) or top-paid ebooks in one storefront country, up to 100 entries. Each entry returns the book title, author, Apple
countryoptstring—limitoptnumber—free_or_paidoptstring—Try it
Test with curl
The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.
curl -X POST https://gateway.pipeworx.io/itunes-search/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'curl -X POST https://gateway.pipeworx.io/itunes-search/mcp \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"search","arguments":{"term": "hello"}}}'Use with the SDK
Install @pipeworx/sdk to call tools from any TypeScript/Node project.
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("search", {"term":"example"});// Or ask in plain English:
const answer = await px.ask("apple itunes store catalog search — music, movies, podcasts, audiobooks, ebooks, apps");