Skip to content

TomeScout

by tomescout.com · remote · no sign-in to list tools · v1.1.0 · published by com.tomescout

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

Changes · 4
CompareRegistry entry

4 tools: 4 change things.

Scanned Oct 21, 2026

No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.

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

Tools

Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.

4 tools

Changes things 4Claude Code: ask
  • bsr_to_salesTurns 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 indep…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Estimate sales from Best Sellers Rank
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • check_listingChecks a book's title, subtitle, description, keyword boxes and categories against Amazon KDP's published metadata guidelines (length limits, allowed HTML, prohibited claims, other…No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Check a KDP listing
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • keyword_boxesPacks keyword phrases (most important first) into KDP's 7 keyword boxes of 50 characters each.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: Fill the 7 KDP keyword boxes
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false
  • royalty_calculatorCalculates KDP royalties per sale.No findings

    Why it is in this group

    • Nothing in its name or description says what it does, so it is counted as a write.
    • The server marks it read-only (readOnlyHint: true), but an annotation never lowers a class.
    Description, as the server wrote it
    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.

    Annotations the server declares

    • title: KDP royalty calculator
    • readOnlyHint: true
    • destructiveHint: false
    • idempotentHint: true
    • openWorldHint: false

This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.

Exfil surface

Which tools read private data, which read text someone else can write, and which can send data out. One of each is a path a prompt injection can use.

No private-data, untrusted-input, outbound path in this server alone: no tool is tagged private-data or untrusted-input or outbound.

Reads private data0
Reads files, mail, messages, databases, secrets, calendars or repositories.
Reads text others write0
Brings in text someone else can write: web pages, inbound email, messages, issues and comments.
Can send data out0
Can carry data to people or systems: it sends, posts or publishes, or takes a recipient, channel or URL.

Other servers in the same agent add their own tools to these paths. Audit your whole setup to see them together.

Install

Pinned to version 1.1.0. Values in angle brackets are yours to fill in.

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

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change or a way out, deny the deletes. Paste into .claude/settings.json.

.claude/settings.json
{
  "permissions": {
    "allow": [],
    "ask": [
      "mcp__tomescout__keyword_boxes",
      "mcp__tomescout__bsr_to_sales",
      "mcp__tomescout__check_listing",
      "mcp__tomescout__royalty_calculator"
    ],
    "deny": []
  }
}

Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. A read that can send data out (it takes a URL, say) asks first too. It assumes the server is installed as tomescout. Review it before you use it.