Keepa MCP server

by purahmanian·io.github.purahmanian/keepa-mcp·v0.1.2

No reviews yet

MCP server for Keepa Amazon price and sales rank history API

B78/100grade B

Write a review Install

What users say

No reviews yet

Be the first

Safety scan

B78/100

full report

Adoption

New

0 stars45 downloads/wk

Reviews

Write one

Nobody has reviewed Keepa yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Keepa tools (6)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

get_best_sellers
Get the top-selling ASINs in a Keepa category. Returns an ordered list of ASINs. Find category ids at: https://keepa.com/#!categorytree/1 Common category ids (amazon.com): - 172282: Electronics - 1055398: Computers & Accessories - 3760901: Camera & Photo - 2619533: Musical Instruments - 284507: Kitchen & Dining Args: - category_id (number): Keepa category id - domain (number, optional): Keepa doma
get_deals
Fetch current Amazon price-drop deals from Keepa. Returns products where the price has dropped significantly, filtered by minimum price drop percentage and minimum rating. Args: - min_price_drop_pct (number, optional): Minimum % price drop (1-99). Default: 20 - min_rating (number, optional): Min rating 0-50 (45 = 4.5 stars). Default: 40 - page (number, optional): Page offset for pagination. Defaul
get_price_history
get_product
get_sales_rank_history
Fetch historical sales rank data for an Amazon ASIN from Keepa. Sales rank (BSR) is a proxy for demand: lower rank = faster sales velocity. Returns a decoded, downsampled time series plus a trend summary. The trend summary indicates whether demand is improving (rank decreasing), worsening (rank increasing), or stable. Args: - asin (string): Amazon ASIN - range (string, optional): Time range. "30d"
search_products
Search for Amazon products on Keepa by keyword. Returns a list of matching ASINs. Use get_product on any returned ASIN to fetch full product details, prices, and history. Args: - keyword (string): Search term, e.g. "wireless earbuds" - category_id (number, optional): Restrict to a Keepa category id. - domain (number, optional): Keepa domain id (default 1 = amazon.com) Examples: - "Find products fo

Public scan report

scanner v0.1.9 · 2026-09-23 · same rubric, same numbers if you re-run it

no findings

Code scan23 source files scanned25/25
–Live reliabilityno gateway calls yet and no remote to proben/a
–Tool poisoningtools not inspected (local package is not executed); not countedn/a
Auth qualitystatic API keys via environment variables6/15
Maintenancelast push 46 days ago12/15
Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.Rubric Appeal a finding JSON

How Keepa compares

Against every graded E-commerce MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score: 78/100; higher than 67% of 2,174 E-commerce servers
Tools: 6; the typical E-commerce server has 6
Tools that change things: 0%; typical: 0%. Fewer write tools means less an agent can break
Downloads a week: 45; more than 42% of 411 E-commerce servers with a package

What its tools let an agent do: 6 read

Install Keepa in Claude Code, Cursor or VS Code

Runs npx -y keepa-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add keepa-mcp -- npx -y keepa-mcp

Add to Cursor

What the publisher says

From the Keepa repository's README, as published. We do not edit it. Read it on GitHub

keepa-mcp

Amazon price and sales-rank history for your AI assistant, via the Keepa API.

Unofficial package. keepa-mcp is not affiliated with, endorsed by, or

supported by Keepa GmbH. "Keepa" and "Amazon" are trademarks of their

respective owners. This is an independent open-source client for the

publicly documented Keepa API.

What it does

Quick start

Claude Desktop

Add to ~/Library/Application Support/Claude/claudedesktopconfig.json (macOS) or %APPDATA%\Claude\claudedesktopconfig.json (Windows):

{
  "mcpServers": {
    "keepa": {
      "command": "npx",
      "args": ["-y", "keepa-mcp"],
      "env": {
        "KEEPA_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Claude Code

claude mcp add keepa -e KEEPA_API_KEY=your_key -- npx -y keepa-mcp

OpenAI Codex CLI

Add to ~/.codex/config.toml:

[mcp_servers.keepa]
command = "npx"
args = ["-y", "keepa-mcp"]

[mcp_servers.keepa.env]
KEEPA_API_KEY = "YOUR_API_KEY_HERE"

Getting a Keepa API key

Sign up at https://keepa.com/#!api to get your API key.

The free tier provides 100 tokens per minute. Each product data request costs tokens proportional to the data retrieved (history length, number of offers, etc.). Typical product lookups cost 1-5 tokens; best-seller lists and deals cost more. See the Keepa API docs for the full token cost table.

Token economics at a glance:

and buybox add-ons it needs. Keepa returns no current price, rating, review count or offer count without them.

get_product: ~2-4 tokens — the product record plus the stats, rating

getpricehistory / getsalesrank_history: ~2-4 tokens
getbestsellers: 50-100 tokens per request
get_deals: 5-25 tokens per page
Free tier refills at 100 tokens/minute

Live offer data (offers) is not requested. It triggers a real-time marketplace lookup costing 10+ extra tokens per call, which on a small bucket can fail the request outright. Versions before 0.1.2 always sent offers=20, so get_product never actually cost the 1 token this table used to claim.

If you hit the quota, the tool returns a clear error message and you can retry after the bucket refills.

Example conversations

1. Product research

"Look up B08N5WRWNW, then show me the last 6 months of price history and

tell me whether demand has been growing."

The assistant calls getproduct, then getpricehistory with range="6m", then getsalesrankhistory with range="6m", and synthesises a verdict.

2. Category opportunity scan

"Pull the top 20 best sellers in Electronics (category 172282), then

get current details and sales rank trends for the first three."

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Keepa: common questions

Is Keepa MCP server safe?: Mostly: it is graded B (78/100). Read the Keepa safety report
How do I install Keepa?: It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Keepa need an API key?: Yes. The registry entry asks for KEEPA_API_KEY.
Is Keepa maintained?: The last commit was 87 days ago (2026-08-09). The latest release is v0.1.2.
What can I use instead of Keepa?: Servers from other publishers that do the same job: BestPrice MCP server, Sessy — Amazon SES observability MCP server and Amazon Ads MCP server.
How does Keepa compare with other E-commerce MCP servers?: safety score 78/100 (higher than 67% of 2,174 E-commerce servers); tools 6 (the typical E-commerce server has 6); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Keepa

Same job from other publishers: the closest match first, then the best rated.

BestPrice
Read-only shopping decisions, product search, offers, and price history for Greece.
not reviewed
Growing
A
Sessy — Amazon SES observability
Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats.
not reviewed
Established
A
Amazon Ads
Amazon Ads API MCP server for Amazon Advertising API
not reviewed
Established
B
HasData Amazon
Amazon keyword search, product details, seller profiles and seller catalogues, as structured JSON.
not reviewed
Growing
A
Apiguru Amazon Data
Live Amazon product, review, search, deal, offer/stock and seller data across 23 marketplaces.
not reviewed
Growing
A