# io.github.purahmanian/keepa-mcp (npm · keepa-mcp)

MCP server for Keepa Amazon price and sales rank history API

- Trust score: 73/100 (medium)
- Change this week: −15
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `keepa-mcp`: 73/100 (this document), [markdown](https://verifymcp.io/servers/purahmanian-keepa-mcp/keepa-mcp.md), [page](https://verifymcp.io/servers/purahmanian-keepa-mcp/keepa-mcp)

## Channel facts

- Registry: `npm`
- Package: `keepa-mcp`
- Version: `0.1.1`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 87/100
  - No malware found by supply-chain analysis.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - Only part of the dependency tree could be resolved (95 of 99), so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to purahmanian/keepa-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 57 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 61/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1598 tokens (~266/item across 6 items; 6 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add purahmanian-keepa-mcp -- npx -y keepa-mcp
```

### Codex

```bash
codex mcp add purahmanian-keepa-mcp -- npx -y keepa-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "purahmanian-keepa-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "keepa-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add purahmanian-keepa-mcp --command npx --arg -y --arg keepa-mcp
```

### Hermes

```yaml
mcp_servers:
  purahmanian-keepa-mcp:
    command: "npx"
    args: ["-y", "keepa-mcp"]
```

### Other

```json
{
  "mcpServers": {
    "purahmanian-keepa-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "keepa-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 73, +68)

- [security improvement] Known CVEs: unverified → partial
- [security improvement] Provenance: unverified → pass
- [security improvement] Install scripts: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [security] The attested source repository moved: purahmanian/keepa-mcp
- [functional regression] Security disclosure: fail → unverified
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] Dependency health: unverified → partial
- [functional improvement] License: unverified → pass
- [functional improvement] Tool coverage: unverified → 100
- [functional] Licence: MIT

### 2026-07-31 (score 5, −1)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 6, −82)

- [security regression] Provenance: pass → unverified
- [security regression] Known CVEs: partial → unverified
- [security regression] Malware scan: pass → unverified
- [security regression] Install scripts: pass → unverified
- [security] The attested source repository moved: purahmanian/keepa-mcp
- [functional regression] License: pass → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Dependency health: partial → unverified
- [functional regression] Maintenance: pass → unverified
- [functional] Licence: MIT

### 2026-07-27 (score 88, +63)

- [security improvement] Install scripts: unverified → pass
- [security improvement] Known CVEs: unverified → partial
- [security improvement] Provenance: unverified → pass
- [security] The attested source repository moved: purahmanian/keepa-mcp
- [functional regression] Security disclosure: unverified → fail
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] License: unverified → pass
- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Tool coverage: 100
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: excellent
- [functional] First check of Schema quality: fail
- [functional] Licence: MIT

### 2026-07-26 (score 25)

First indexed and scored.

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

## MCP tools (6)

### `get_product` (~316 tokens)

Get Product Details

Fetch current product details from Keepa for a given Amazon ASIN.

Returns: title, brand, category path, current Amazon price, new (3P) price, buy box price,
review count, star rating, number of new offers, and latest sales rank.

Prices are in USD. A value of "N/A" means the price type is not currently available.

Args:
  \- asin (string): Amazon ASIN, e.g. "B08N5WRWNW"
  \- domain (number, optional): Keepa domain id (default 1 = amazon.com)

Examples:
  \- "What is the current price of ASIN B08N5WRWNW?" -> use get_product with asin="B08N5WRWNW"
  \- "Show me product details for B07PXGQC1Q" -> use get_product with asin="B07PXGQC1Q"

Error handling:
  \- Returns an instructional message if KEEPA_API_KEY is missing.
  \- Returns a not-found message for invalid ASINs.

Input parameters:

- `asin` (string, required): Amazon ASIN or product code (e.g. B08N5WRWNW)
- `domain` (integer): Keepa domain id: 1=amazon.com, 2=amazon.co.uk, 3=amazon.de, 4=amazon.fr, 5=amazon.co.jp, 6=amazon.ca, 8=amazon.it, 9=amazon.es, 10=amazon.in

### `get_price_history` (~313 tokens)

Get Price History

Fetch historical price data for an Amazon ASIN from Keepa.

Returns a decoded, downsampled time series (at most 60 data points) for:
  \- Amazon price (sold by Amazon directly)
  \- New (3P) price (lowest new third-party price)
  \- Used price (lowest used price)
  \- Buy box price

Keepa stores prices in cents. All prices returned are in USD.
Keepa time values (minutes since 2011-01-01) are decoded to ISO dates.

Args:
  \- asin (string): Amazon ASIN
  \- range (string, optional): Time range. "30d", "6m", "1y", "all". Default: "90d"
  \- domain (number, optional): Keepa domain id (default 1 = amazon.com)

Examples:
  \- "Show price history for B08N5WRWNW over the past year" -> range="1y"
  \- "What has the Amazon price been for B07PXGQC1Q in the last 30 days?" -> range="30d"

Input parameters:

- `asin` (string, required): Amazon ASIN
- `domain` (integer): Keepa domain id (1 = amazon.com)
- `range` (string): Time range for history. Examples: "30d" (30 days), "6m" (6 months), "1y" (1 year), "all" (full history). Default: 90d

### `get_sales_rank_history` (~255 tokens)

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", "6m", "1y", "all". Default: "90d"
  \- domain (number, optional): Keepa domain id (default 1 = amazon.com)

Examples:
  \- "Is demand trending up or down for B08N5WRWNW?" -> use get_sales_rank_history
  \- "Show 6-month BSR history for B07PXGQC1Q" -> range="6m"

Input parameters:

- `asin` (string, required): Amazon ASIN
- `domain` (integer): Keepa domain id (1 = amazon.com)
- `range` (string): Time range for history. Examples: "30d", "6m", "1y", "all". Default: 90d

### `search_products` (~212 tokens)

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 for 'yoga mat'" -> keyword="yoga mat"
  \- "Search Electronics for 'USB-C hub'" -> keyword="USB-C hub", category_id=172282

Input parameters:

- `category_id` (integer): Optional Keepa category id to restrict results. Find ids via get_best_sellers or Keepa category tree.
- `domain` (integer): Keepa domain id (1 = amazon.com)
- `keyword` (string, required): Search keyword or phrase (e.g. 'wireless earbuds')

### `get_best_sellers` (~236 tokens)

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 domain id (default 1 = amazon.com)

Examples:
  \- "What are the best sellers in Electronics?" -> category_id=172282
  \- "Top Kitchen products" -> category_id=284507

Input parameters:

- `category_id` (integer, required): Keepa category id (e.g. 172282 for Electronics on amazon.com). Find ids in the Keepa category tree at https://keepa.com/#!categorytree/1
- `domain` (integer): Keepa domain id (1 = amazon.com)

### `get_deals` (~266 tokens)

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. Default: 0
  \- domain (number, optional): Keepa domain id (default 1 = amazon.com)

Examples:
  \- "Show me deals with at least 30% off" -> min_price_drop_pct=30
  \- "Find highly-rated products on sale" -> min_rating=45, min_price_drop_pct=20

Input parameters:

- `domain` (integer): Keepa domain id (1 = amazon.com)
- `min_price_drop_pct` (integer): Minimum price drop percentage to include. Default: 20
- `min_rating` (integer): Minimum product rating (0-50, where 45 = 4.5 stars). Default: 40
- `page` (integer): Page offset for pagination. Default: 0 (first page)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/purahmanian-keepa-mcp/keepa-mcp#diagnostics

## Score history

- 2026-08-03: 73
- 2026-08-02: 73
- 2026-08-01: 5
- 2026-07-31: 5
- 2026-07-30: 6
- 2026-07-28: 88
- 2026-07-27: 88
- 2026-07-26: 25

## Links

- npm package: https://www.npmjs.com/package/keepa-mcp
- Socket report: https://socket.dev/npm/package/keepa-mcp
- Repository: https://github.com/purahmanian/keepa-mcp
- Changelog RSS feed: https://verifymcp.io/servers/purahmanian-keepa-mcp/keepa-mcp/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/purahmanian-keepa-mcp/keepa-mcp/changelog.json
- HTML version of this page: https://verifymcp.io/servers/purahmanian-keepa-mcp/keepa-mcp