`top_podcasts`

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_podcasts for the schema, then POST the same URL with its arguments for the data.

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 — 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.

top_podcasts