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 100 Amazon calls at the 10-credit rate.

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

• Prompts and resources

Contents

• What you need
• Quick start
• Example prompts
• Tools
• Errors and failure paths
• Pricing, free tier and limits
• Tool selection
• How it compares
• FAQ
• HasData links
• Development
• Contributing
• License

What you need

An MCP client and a HasData API key from the dashboard, free to create with no card, and the free tier covers about 100 calls a month at the 10-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/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>

claude mcp add --transport http amazon "https://mcp.hasdata.com/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/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:

{
  "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:

{
  "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:

{
  "mcpServers": {
    "amazon": {
      "url": "https://mcp.hasdata.com/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:

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

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

.vscode/mcp.json in the workspace:

{
  "servers": {
    "amazon": {
      "type": "http",
      "url": "https://mcp.hasdata.com/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

| Tool | What it returns | | --- | --- | | hasdata_amazon_product_getProductDetails | Title, brand, current/list/deal price, currency, availability, Buy Box seller, Prime eligibility, bullet points, A+ description, rating and review count, images,…. 10 credits a call | | hasdata_amazon_reviews_getProductReviews | Per-review title, body, star rating, author name and profile, review date, country, verified-purchase flag, helpful-vote count, variant/format attributes, and attached…. 10 credits a call | | hasdata_amazon_search_getSearchResults | The organic results list with ASIN, title, thumbnail, product URL, price and list price, currency, star rating, review count, Prime/sponsored flags, and position, plus…. 10 credits a call | | hasdata_amazon_seller_getSellerDetails | Business name, seller logo, About-this-seller text, overall feedback rating and lifetime/12-month/90-day/30-day rating breakdown, feedback count, business address and…. 10 credits a call | | hasdata_amazon_seller_products_getSellerProducts | Each product row with ASIN, title, image, product URL, price and list price, currency, star rating, review count, and Prime flag. 10 credits a call |

Five tools, 10 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

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.

{
  "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

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 10 credits on top of the base, 15 instead of 10 | | 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 costs half again as much.

{
  "asin": "B0DHJ7SBDR",
  "title": "Apple iPhone 16 Pro Max, 1TB, Desert Titanium",
  "brand": "Apple",
  "condition": "Refurbished - Excellent",
  "price": {
    "symbol": "$",
    "currentPrice": 974,
    "beforePrice": 949.99,
    "discount": "-11%",
    "otherOfferQuantity": 11
  },
  "seller": "WirelessSource",
  "deliveryIsoDate": "2026-09-11T00:00:00.000Z"
}

Get Amazon seller details

hasdata_amazon_seller_getSellerDetails

The public storefront profile of one seller.

| Parameter | Type | Required | Notes | | :--- | :--- | :--- | :--- | | sellerId | string | yes | The seller ID, which a product response returns in sellerUrl | | domain | string | | Marketplace, defaults to www.amazon.com | | language | string | | Marketplace language code |

Returns a seller object with sellerId, url, storefrontUrl, name, businessName, businessAddress, an about block, and four ratin