Docs

TomeScout is a remote MCP server. Add its URL to your AI assistant once; then just ask about your book.

Connect

Server URL: https://tomescout.com/mcp

Claude (web, desktop, mobile)

TomeScout is listed in Claude's connector directory: open TomeScout in the directory and select Connect to Claude. To add it by hand instead:

  1. Open Settings → Connectors → Add custom connector.
  2. Name it TomeScout and paste https://tomescout.com/mcp.
  3. No sign-in is needed. Start a chat and ask about your KDP listing.

Claude Code

claude mcp add --transport http tomescout https://tomescout.com/mcp

Or install the plugin, which adds the connector plus KDP publishing skills: github.com/semrebayrak/tomescout-claude-plugin.

ChatGPT

Turn on developer mode in ChatGPT's settings and add a custom MCP connector with the URL https://tomescout.com/mcp and no authentication. OpenAI moves these menus often; its help centre has the current path.

Cursor, VS Code and other MCP clients

{
  "mcpServers": {
    "tomescout": { "url": "https://tomescout.com/mcp" }
  }
}

TomeScout Toolkit URL

https://tomescout.com/mcp/toolkit is the address listed in Claude's connector directory. It serves the same four tools as https://tomescout.com/mcp.

Tools

Every tool calculates from what you pass in, KDP's published guidelines and KDP's price tables. Nothing is fetched from Amazon or any other site.

keyword_boxes

Packs your phrases (most important first) into seven 50-character boxes, removes words already in your title and subtitle, and leaves out other authors' names, book titles, trademarks, Amazon programme names and price or sales claims.

check_listing

Title, subtitle, description, keywords and categories in; errors, warnings and tips out, each linked to the KDP help page it comes from. Covers the 200-character title limit, allowed description HTML, 4,000-character descriptions, three categories, and prohibited content (sales claims, promotions, programme names, other authors, trademarks, contact details, review requests, emojis).

royalty_calculator

eBook royalties in 13 Amazon stores with the price bands in force since 7 July 2026 (US $2.99–$12.99 for 70%), delivery costs and VAT; paperback printing cost, 60%/50% tier and minimum list price on Amazon.com, .co.uk and EU stores; optional Kindle Unlimited earnings from pages read.

bsr_to_sales

A Best Sellers Rank you read on Amazon in, a range of daily and monthly units out. Two public models — a rank-band table based on Theresa Ragan's published sales data and TCK Publishing's curve fit — are shown side by side. Treat UK and DE figures as rough.

Amazon Ads for authors (in development)

We are building ad management for KDP authors: you connect your own Amazon Ads account, and TomeScout gives keyword and bid recommendations for your books, search terms from your campaigns worth adding or blocking, and performance reports. Only you will see your account's data. Not available yet.

Limits