`books_bestsellers`

Pack: nyt · 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/books_bestsellers for the schema, then POST the same URL with its arguments for the data.

Get a current New York Times bestselling books list (e.g. hardcover-fiction, hardcover-nonfiction, combined-print-and-e-book-fiction). Returns rank, title, author, description, publisher, and weeks on list. Example: books_bestsellers({ list: “hardcover-fiction” })

Parameters

Name	Type	Required	Description
`list`	string	no	Bestseller list name, e.g. “hardcover-fiction”, “hardcover-nonfiction”, “combined-print-and-e-book-fiction”. Default “hardcover-fiction”.
`_apiKey`	string	no	Optional — your own NYT API key for higher limits; omit to use the shared Pipeworx key.

Example call

Arguments

{
  "list": "hardcover-fiction"
}

curl

curl -X POST https://gateway.pipeworx.io/nyt/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"books_bestsellers","arguments":{"list":"hardcover-fiction"}}}'

TypeScript (@pipeworx/sdk)

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

const result = await pipeworx.call('books_bestsellers', {
  "list": "hardcover-fiction"
});

More examples

{
  "list": "hardcover-nonfiction"
}

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 nyt pack

{
  "mcpServers": {
    "nyt": {
      "url": "https://gateway.pipeworx.io/nyt/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

books_bestsellers