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)

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

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 (calculation-only server)

https://tomescout.com/mcp/toolkit serves four of the six tools: keyword_boxes, check_listing, royalty_calculator and bsr_to_sales. They calculate from what you pass in plus KDP's published guidelines and price tables, and never contact Amazon or any other site. Use it where a server must not call third-party services; add the full server above for live keyword research and Amazon Ads lists.

Tools

keyword_research

Input: a seed phrase (“cozy mystery”, “keto cookbook”) and a store (Kindle Store or Books). Output: up to 100 phrases shoppers type on Amazon.com, each with a 0–100 strength score and a placement:

keyword_boxes

Packs phrases (most important first) into seven 50-character boxes, removes words already in your title and subtitle, and refuses anything flagged ads-only or avoid.

ads_keywords

One to five seeds in, up to 300 Amazon Ads keyword targets out, one per line.

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

How strength is measured

For each phrase we record the shortest prefix after which Amazon offers it, and its position in the list. A phrase offered after a shopper types a third of it, in first place, scores near 90; one that appears only when almost fully typed, in last place, scores under 10. Amazon does not publish search volumes for books, so strength is a relative signal — compare phrases within one result, and never read it as a number of searches.

Limits