`top_podcasts`

Pack: itunes-search · Endpoint: https://gateway.pipeworx.io/itunes-search/mcp

Apple 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, genre list, release date, artwork URL and Apple Podcasts link. Answers which podcasts are most popular on Apple Podcasts right now in the US or another country.

Parameters

Name	Type	Required	Description
`country`	string	no
`limit`	number	no

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_podcasts","arguments":{"country":"us","limit":25}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('top_podcasts', {
  "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 podcasts",
          "items": {
            "type": "object",
            "properties": {
              "artistName": {
                "type": "string",
                "description": "Podcast title"
              },
              "id": {
                "type": "string",
                "description": "Podcast ID"
              },
              "releaseDate": {
                "type": "string",
                "description": "Release date"
              },
              "name": {
                "type": "string",
                "description": "Podcast name"
              },
              "kind": {
                "type": "string",
                "description": "Media kind"
              },
              "copyright": {
                "type": "string",
                "description": "Copyright info"
              },
              "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, or use one-click install buttons:

{
  "mcpServers": {
    "itunes-search": {
      "url": "https://gateway.pipeworx.io/itunes-search/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

top_podcasts