amazon-mcp

# Amazon MCP Server

<!-- mcp-name: com.hasdata/amazon -->

A hosted Model Context Protocol (MCP) server that gives Claude, Cursor, Windsurf and any other MCP client four read-only Amazon tools. Run a keyword search, read one product by its ASIN, look up a seller, and page through what that seller stocks, all as structured JSON, with no Amazon developer account and nothing to host.

It reads public Amazon pages that a signed-out visitor can see, on any of the 23 regional domains.

**1,000 free credits every month, no card required**, which is 200 Amazon calls at the 5-credit rate.

```
https://mcp.hasdata.com/api/mcp?apis=amazon
```

[![Glama score](https://glama.ai/mcp/servers/HasData/amazon-mcp/badges/score.svg)](https://glama.ai/mcp/servers/HasData/amazon-mcp)
[![tool contract](https://github.com/HasData/amazon-mcp/actions/workflows/contract.yml/badge.svg)](https://github.com/HasData/amazon-mcp/actions/workflows/contract.yml)
[![MCP](https://img.shields.io/badge/MCP-remote%20%7C%20streamable%20HTTP-6366f1?style=flat-square)](https://mcp.hasdata.com/api/mcp?apis=amazon)
[![Tools](https://img.shields.io/badge/tools-4-10b981?style=flat-square)](#tools)
[![npm](https://img.shields.io/npm/v/@hasdata/amazon-mcp?style=flat-square&logo=npm&label=npm&color=cb3837)](https://www.npmjs.com/package/@hasdata/amazon-mcp)
[![PyPI](https://img.shields.io/pypi/v/hasdata-amazon-mcp?style=flat-square&logo=pypi&logoColor=white&label=PyPI&color=3775a9)](https://pypi.org/project/hasdata-amazon-mcp/)
[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)

## Contents

- [What you need](#what-you-need)
- [Quick start](#quick-start)
- [Example prompts](#example-prompts)
- [Tools](#tools)
- [Errors and failure paths](#errors-and-failure-paths)
- [Pricing, free tier and limits](#pricing-free-tier-and-limits)
- [Tool selection](#tool-selection)
- [How it compares](#how-it-compares)
- [FAQ](#faq)
- [HasData links](#hasdata-links)
- [Development](#development)
- [Contributing](#contributing)
- [License](#license)

## What you need

An MCP client and a HasData API key from the [dashboard](https://app.hasdata.com/sign-up?utm_source=github&utm_medium=syndication&utm_campaign=amazon-mcp), free to create with no card, and the free tier covers about 200 calls a month at the 5-credit rate. This is a remote server, so the simplest path is a URL and an `x-api-key` header, with no container to run. A client that only speaks stdio reaches it through a thin launcher, published as `@hasdata/amazon-mcp` on npm and `hasdata-amazon-mcp` on PyPI, shown below.

## Quick start

The server URL is the same for every client. We run it hands-on in Claude Code and Claude Desktop. The other blocks follow each client's own documented format for a remote server.

| Field | Value |
| :--- | :--- |
| URL | `https://mcp.hasdata.com/api/mcp?apis=amazon` |
| Transport | HTTP, streamable |
| Auth header | `x-api-key: HASDATA_API_KEY` |

Clients with OAuth support can add the same URL as a connector and sign in without putting a key in a config file.

<details>
<summary><b>Claude Code</b></summary>

```bash
claude mcp add --transport http amazon "https://mcp.hasdata.com/api/mcp?apis=amazon" \
  --header "x-api-key: HASDATA_API_KEY"
```

</details>

<details>
<summary><b>Claude Desktop</b></summary>

Settings, then Connectors, then Add custom connector, then paste `https://mcp.hasdata.com/api/mcp?apis=amazon` and sign in.

For the config-file route, Claude Desktop loads only local (stdio) servers, so it reaches a remote server through a stdio launcher. The `@hasdata/amazon-mcp` package is that launcher, and it reads the key from the environment. Add this to `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "amazon": {
      "command": "npx",
      "args": ["-y", "@hasdata/amazon-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}
```

For Python instead of Node, swap the launcher for the PyPI package, which `uvx` runs without a manual install:

```json
{
  "mcpServers": {
    "amazon": {
      "command": "uvx",
      "args": ["hasdata-amazon-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}
```

</details>

<details>
<summary><b>Cursor</b></summary>

`~/.cursor/mcp.json` for every project, or `.cursor/mcp.json` for one:

```json
{
  "mcpServers": {
    "amazon": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=amazon",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}
```

</details>

<details>
<summary><b>Windsurf</b></summary>

`~/.codeium/windsurf/mcp_config.json`. Windsurf calls the field `serverUrl`, not `url`:

```json
{
  "mcpServers": {
    "amazon": {
      "serverUrl": "https://mcp.hasdata.com/api/mcp?apis=amazon",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}
```

</details>

<details>
<summary><b>VS Code</b></summary>

`.vscode/mcp.json` in the workspace:

```json
{
  "servers": {
    "amazon": {
      "type": "http",
      "url": "https://mcp.hasdata.com/api/mcp?apis=amazon",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}
```

</details>

## Example prompts

Each of these lands on one tool, or on two in sequence when the second needs an identifier the first returns.

- Find laptop stands under $40 on Amazon and sort them by average customer review.
- What does ASIN B0DHJ7SBDR cost right now, and how many other sellers offer it?
- Compare the price of this ASIN on amazon.com and amazon.de.
- Who is the seller behind ASIN B0DHJ7SBDR, and what is their lifetime rating?
- Page through everything seller ATQQBVXK188KS stocks and pull out the discounted items.
- Search for wireless earbuds with delivery to 10001 and tell me which arrive fastest.

A prompt that names a product rather than an ASIN takes two calls, one search to resolve the ASIN and one product lookup to read it. A prompt that names a seller by brand rather than by seller ID takes the same shape, one product lookup to find the seller ID and one seller lookup to read the profile.

## Tools

Four tools, 5 credits per successful call. Every tool accepts `domain` to switch marketplace, one of 23 values, `www.amazon.com` through the European, Asian and other regional marketplaces, and `language` where the marketplace offers more than one.

### Get Amazon search results

[`hasdata_amazon_search_getSearchResults`](https://docs.hasdata.com/apis/amazon/search?utm_source=github&utm_medium=syndication&utm_campaign=amazon-mcp)

A page of search results for a keyword.

| Parameter | Type | Required | Notes |
| :--- | :--- | :--- | :--- |
| `q` | string | yes | The search term |
| `domain` | string | | Marketplace, defaults to `www.amazon.com` |
| `page` | number | | Result page, starting at 1 |
| `sortBy` | string | | `featured`, `priceLowToHigh`, `priceHighToLow`, `avgCustomerReview`, `newestArrivals` or `bestSellers` |
| `deliveryZip` | string | | Postal code, which changes availability and delivery dates |
| `shippingLocation` | string | | Two-letter country code for the delivery address |
| `language` | string | | Marketplace language code |

Returns `productResults`, an `ads` array of sponsored placements, and `pagination` with `totalResults`, `currentPage`, `nextPageUrl` and `otherPageUrls`. Each result carries `position`, `asin`, `title`, `url`, `isSponsored`, a `price` object, `image`, `reviews` with `rating` and `totalReviews`, a `badges` object, `boughtInPastMonth` and `deliveryInfo`.

> A search result is deliberately thin. Brand, features, variants, images and the seller are not here, they come from the product tool below. Resolve the ASIN first, then read the product.

```json
{
  "position": 1,
  "asin": "B077B9W343",
  "title": "Nulaxy Ergonomic Adjustable Laptop Stand for Desk, Dual Foldable Computer Riser...",
  "isSponsored": false,
  "price": { "symbol": "$", "currentPrice": 15.99, "beforePrice": 17.99 },
  "image": "https://m.media-amazon.com/images/I/61jtA8kHq9L.jpg",
  "reviews": { "totalReviews": 16800, "rating": 4.7 },
  "badges": { "amazonChoice": true, "amazonPrime": false, "bestSeller": false },
  "boughtInPastMonth": "10K+",
  "deliveryInfo": { "freeDelivery": "Join Prime", "fastestDelivery": "Mon, Sep 14" },
  "url": "https://www.amazon.com/dp/B077B9W343"
}
```

### Get Amazon product details

[`hasdata_amazon_product_getProductDetails`](https://docs.hasdata.com/apis/amazon/product?utm_source=github&utm_medium=syndication&utm_campaign=amazon-mcp)

One product in full, by its ASIN.

| Parameter | Type | Required | Notes |
| :--- | :--- | :--- | :--- |
| `asin` | string | yes | The Amazon Standard Identification Number |
| `domain` | string | | Marketplace, defaults to `www.amazon.com` |
| `otherSellers` | boolean | | Also collect competing offers. Costs 5 credits on top of the base, 10 instead of 5 |
| `deliveryZip` | string | | Postal code, which changes availability and delivery dates |
| `shippingLocation` | string | | Two-letter country code for the delivery address |
| `language` | string | | Marketplace language code |

Returns a `product` object with `asin`, `url`, `title`, `brand`, `isAvailable`, `condition`, a `price` object, `primaryFeatures` and a wider `features` map, `featureBullets`, `description`, `variants`, `breadcrumbs`, `whatIsInTheBox`, image and video collections, `specification`, `reviewsInfo`, the delivery estimates, and the current `seller` with `sellerUrl`.

The `price` object holds `currentPrice`, `beforePrice` when the item is discounted, `discount`, `priceFrom` and `otherOfferQuantity`. That last field is a count of competing offers, which the base call reports without fetching them. Ask for `otherSellers` only when the offers themselves are needed, because it doubles the price of the call.

```json
{
  "asin": "B0DHJ7SBDR",
  "title": "Apple iPhone 16 Pro Max, 1TB, Desert Titanium",
  "brand": "Apple",
  "condition": "Refurbished - Excellent",
  "price": {
    "symbol": "$",
    "currentPrice": 974,
    "beforePrice": 949.99,
    "d