TomeScout

com.tomescoutPublished by tomescout.comOfficial publisherv1.1.0Updated Oct 24, 2026

KDP keyword boxes, listing checks, royalties and sales-from-rank for self-published authors

VerifiedStreamable HTTPWeb executableData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Lets an assistant pack KDP keyword boxes, audit book listings, calculate Amazon royalties and estimate sales from Best Sellers Rank.

What you can do
Four tools support self-published authors on Amazon KDP. keyword_boxes packs keyword phrases into the seven 50-character keyword boxes, removing words already in the title or subtitle and dropping prohibited or trademarked phrases. bsr_to_sales converts an Amazon Best Sellers Rank into estimated daily and monthly unit ranges using two public models. check_listing compares title, subtitle, description, keywords and categories against KDP metadata guidelines and gives optimisation tips. royalty_calculator computes eBook and paperback royalties across Amazon stores, with optional Kindle Unlimited earnings.
When to use it
Useful when preparing or revising a KDP book listing: choosing keywords, checking metadata before publishing, estimating sales from a rank, or comparing royalty outcomes for eBook and paperback pricing.
Requirements
A remote MCP endpoint at tomescout.com over streamable HTTP; no packages, environment variables or headers are declared. No authentication is declared.
Before you install
Estimates from bsr_to_sales are model-based ranges, not actual sales data, and non-US stores are described as rough scalings. Royalty figures depend on current price bands and rules and should be verified against Amazon's own documentation before pricing decisions.

Installation

In SourceWeft

  1. Open TomeScout in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.tomescout%2Ftomescout/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

Tools

4

keyword_boxes

Fill the 7 KDP keyword boxes

Packs keyword phrases (most important first) into KDP's 7 keyword boxes of 50 characters each. Removes words already in the title/subtitle, drops prohibited, trademarked and likely author/title phrases, and reports what did not fit.

ParameterstitlephrasesrequiredsubtitleskipTitleWords

bsr_to_sales

Estimate sales from Best Sellers Rank

Turns an Amazon Best Sellers Rank (the 'Best Sellers Rank' line on a book's Amazon page, overall store rank) into an estimated range of units per day and per month, using two independent public models. Amazon.com (Kindle Store or print); UK/DE are rough scalings. Optionally multiplies by royalty per sale.

ParametersbsrrequiredformatmarketplaceroyaltyPerSale

check_listing

Check a KDP listing

Checks a book's title, subtitle, description, keyword boxes and categories against Amazon KDP's published metadata guidelines (length limits, allowed HTML, prohibited claims, other authors/titles/trademarks, programme names, contact details, review requests, emojis) and gives optimisation tips. Each issue links to the KDP help page it comes from.

Parameterstitlerequiredkeywordssubtitlecategoriesdescription

royalty_calculator

KDP royalty calculator

Calculates KDP royalties per sale. eBook: 70% vs 35% option for any of 13 Amazon stores (current 2026 price bands, delivery cost per MB, VAT/GST handling, KDP Select rules). Paperback: printing cost and royalty on Amazon.com/.co.uk/EU stores (60% or 50% tier). Optional Kindle Unlimited earnings from pages read.

ParametersinktrimpagesformatrequiredkdpSelectlistPricerequiredfileSizeMbmarketplacemonthlySalesprintListPricekuPagesReadPerMonth

Version history

2
  1. v1.1.0LatestSep 26, 2026
  2. v1.0.0Sep 26, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.