`top_books`

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

Apple 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 id, genres, release date, artwork URL and Apple Books link. Answers which ebooks are topping the Apple Books charts today.

Parameters

Name	Type	Required	Description
`country`	string	no
`limit`	number	no
`free_or_paid`	string	no	top-free \| top-paid (default top-free)

Example call

Arguments

{
  "country": "us",
  "limit": 25,
  "free_or_paid": "top-paid-books"
}

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_books","arguments":{"country":"us","limit":25,"free_or_paid":"top-paid-books"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('top_books', {
  "country": "us",
  "limit": 25,
  "free_or_paid": "top-paid-books"
});

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 books",
          "items": {
            "type": "object",
            "properties": {
              "artistName": {
                "type": "string",
                "description": "Book author"
              },
              "id": {
                "type": "string",
                "description": "Book ID"
              },
              "releaseDate": {
                "type": "string",
                "description": "Release date"
              },
              "name": {
                "type": "string",
                "description": "Book 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_books