`top_books`

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

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, 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_books