Log inSubmit server
Keepa MCP logo

Keepa MCP

Queries Keepa for Amazon product data, price history, sales rank trends, search results, best sellers, and deals.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Keepa MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "keepa-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "keepa-mcp"
      ],
      "env": {
        "KEEPA_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 6 tools correctly (10d ago).

Overview

The keepa-mcp MCP server connects AI assistants to the Keepa API for Amazon product and market research. It provides tools for product details, decoded price and sales-rank histories, keyword search, category best sellers, and price-drop deals. Run it locally through a standard MCP configuration and provide a Keepa API key through the KEEPA_API_KEY environment variable. Reach for it when an agent needs historical pricing or demand signals rather than only a current product lookup.

Use cases

  • Research Amazon product pricing by ASIN
  • Compare historical prices before evaluating a deal
  • Track sales-rank trends for product demand
  • Find products and best sellers by category
  • Filter Amazon deals by discount and rating

Key features

  • Retrieve Keepa product details
  • Decode price history time series
  • Summarize sales-rank trends
  • Search products by keyword
  • List category best sellers
  • Filter price-drop deals

Tools6

What Keepa MCP lets your agent do. Expand a tool for its parameters.

Verified live~1.8k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

6/6 checks healthy over the last 46d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 12d ago via OSV.dev · keepa-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads265Package downloads in the last 30 days.
Last commit2mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed6Callable tools this server registers over MCP.
Directory activity9 viewsConfig copies, upvotes, and views on AllMCPs.

How Keepa MCP works

What keepa-mcp MCP server does

The keepa-mcp MCP server exposes selected Keepa API operations as MCP tools for Amazon research. It can retrieve product records containing titles, brands, categories, current prices, buy-box information, review counts, and ratings. It also turns Keepa history data into decoded time series for Amazon, new, used, and buy-box prices, and provides sales-rank history with a demand-trend summary.

The server supports both ASIN-based analysis and discovery workflows. Agents can search products by keyword, request the top ASINs in a Keepa category, or find current deals using price-drop and rating filters. These results can be combined: for example, an agent can find a deal, identify its ASIN, and inspect its longer-term price history.

How it works

The server runs on the local machine and sends requests to api.keepa.com. It passes the API key and the ASINs, keywords, or category IDs supplied through tool calls to Keepa. It does not collect telemetry or store data, according to the project documentation.

Each operation consumes Keepa tokens. Typical product and history requests use roughly 1–5 tokens, while best-seller requests can use 50–100 tokens and deal searches can use 5–25 tokens per page. The free tier refills at 100 tokens per minute. If the quota is exhausted, the tool reports an error that can be retried after the bucket refills.

Live offer data is deliberately not requested by the current implementation. That avoids the additional 10-or-more-token marketplace lookup associated with the offers parameter.

Setup and configuration

Install and launch the keepa-mcp MCP server with npx, or build it from the repository with npm. The required configuration value is:

  • KEEPA_API_KEY: Keepa API key used for all API requests.

Claude Desktop, Claude Code, and OpenAI Codex CLI configuration examples are provided in the project documentation. The Claude Desktop and Codex examples start npx -y keepa-mcp and inject the key as an environment variable. Claude Code can add the same command with claude mcp add.

For local development, the repository documents npm install, npm test, and npm run build. The compiled server can be started with node dist/index.js when KEEPA_API_KEY is present.

Tools and capabilities

The keepa-mcp MCP server registers six tools:

  • get_product retrieves core product details, current pricing, buy-box data, ratings, reviews, and offer counts available in the requested record.
  • get_price_history returns decoded price series for Amazon, new, used, and buy-box prices.
  • get_sales_rank_history returns rank history and a demand-trend summary.
  • search_products finds matching ASINs from a keyword query.
  • get_best_sellers returns leading ASINs for a Keepa category.
  • get_deals filters current price-drop deals by discount percentage and rating.

The history tools accept a range such as six months, allowing an agent to compare current conditions with a defined historical period.

Limitations and notes

This is an unofficial, independent client and is not affiliated with or endorsed by Keepa GmbH or Amazon. A valid Keepa API key and available API tokens are required. Request costs vary with the operation and amount of data retrieved, so large category and deal queries can consume substantially more of a small token bucket than an individual product lookup. The server sends requests only to Keepa and does not write the API key to disk.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Keepa MCP

keepa-mcp is an MCP server that connects AI assistants to the Keepa API for Amazon research. Its main tools retrieve product details, decode price and sales-rank history, search products, list category best sellers, and filter current deals by price drop and rating. It runs locally and requires a Keepa API key.

Install it by configuring an MCP client to run `npx -y keepa-mcp` and passing `KEEPA_API_KEY` as an environment variable. The README includes configurations for Claude Desktop, Claude Code, and OpenAI Codex CLI. From the source repository, you can also run `npm install` and build with `npm run build`.

keepa-mcp requires `KEEPA_API_KEY`. Set it to a valid Keepa API key in the MCP client configuration or shell environment before starting the server. The key is used for requests to Keepa and is not written to disk.

Token usage depends on the tool and the amount of data requested. Product and history calls typically use about 1–5 tokens, best-seller requests about 50–100 tokens, and deal searches about 5–25 tokens per page. The documented free tier refills at 100 tokens per minute.

No. keepa-mcp does not request live offer data through the `offers` parameter. The project omits that lookup because it can add 10 or more tokens to a request and may fail against a small token bucket.

Related MCP servers

All in E-Commerce All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewKeepa MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/keepa-mcp?style=directory)](https://allmcps.com/mcp/keepa-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/keepa-mcp"><img src="https://allmcps.com/api/badge/keepa-mcp?style=directory" alt="Keepa MCP on AllMCPs" /></a>