# Amazon Mcp > Amazon MCP server by HasData: keyword search, product details, seller profiles and seller catalogues, as JSON. - **Type:** MCP server - **Install:** `agentstack add mcp-hasdata-amazon-mcp` - **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior - **Seller:** [HasData](https://agentstack.voostack.com/s/hasdata) - **Installs:** 0 - **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml) - **Latest version:** 0.1.0 - **License:** MIT - **Upstream author:** [HasData](https://github.com/HasData) - **Source:** https://github.com/HasData/amazon-mcp - **Website:** https://hasdata.com/apis/amazon-api ## Install ```sh agentstack add mcp-hasdata-amazon-mcp ``` Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent. ## About # Amazon MCP Server 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 ``` [](https://glama.ai/mcp/servers/HasData/amazon-mcp) [](https://github.com/HasData/amazon-mcp/actions/workflows/contract.yml) [](https://mcp.hasdata.com/api/mcp?apis=amazon) [](#tools) [](https://www.npmjs.com/package/@hasdata/amazon-mcp) [](https://pypi.org/project/hasdata-amazon-mcp/) [](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. Claude Code ```bash claude mcp add --transport http amazon "https://mcp.hasdata.com/api/mcp?apis=amazon" \ --header "x-api-key: HASDATA_API_KEY" ``` Claude Desktop 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" } } } } ``` Cursor `~/.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" } } } } ``` Windsurf `~/.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" } } } } ``` VS Code `.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" } } } } ``` ## 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,…. 5 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…. 5 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…. 5 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…. 5 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. 5 credits a call | Five 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, "discount": "-11%", "otherOfferQuantity": 11 }, "seller": "WirelessSource", "deliveryIsoDate": "2026-09-11T00:00:00.000Z" } ``` ### Get Amazon seller details [`hasdata_amazon_seller_getSellerDetails`](https://docs.hasdata.com/apis/amazon/seller?utm_source=github&utm_medium=syndication&utm_campaign=amazon-mcp) 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 rating windows named `oneMonthRatings`, `threeMonthRatings`, `twelveMonthRating` and `lifetimeRating`. Each window carries `totalVotes`, `averageRating` and a per-star breakdown with both `votes` and `percent`. The four windows are what make this tool worth a call. A lifetime average of 4.5 over 2,701 votes and a one-month average of 2 over 4 votes describe very different sellers, and only the pair shows a decline in progress. ```json { "sellerId": "ATQQBVXK188KS", "name": "Expercom - Apple Premier Partner", "businessName": "Expercom of Utah, Inc", "lifetimeRating": { "totalVotes": 2701, "averageRating": 4.5 }, "oneMonthRatings": { "totalVotes": 4, "averageRating": 2 } } ``` ### Get Amazon seller products [`hasdata_amazon_seller_products_getSellerProducts`](https://docs.hasdata.com/apis/amazon/seller-products?utm_source=github&utm_medium=syndication&utm_campaign=amazon-mcp) A page of what one seller stocks. | Parameter | Type | Required | Notes | | :--- | :--- | :--- | :--- | | `sellerId` | string | yes | The seller ID | | `domain` | string | | Marketplace, defaults to `www.amazon.com` | | `page` | number | | Result page, starting at 1 | | `language` | string | | Marketplace language code | Returns `productResults` and `pagination`, shaped like the search tool's output. Each item carries `position`, `asin`, `title`, `url`, `price`, `image`, `reviews`, `badges`, `boughtInPastMonth`, `deliveryInfo` and `colorUrls`. Walk `pagination` to reach the rest of the catalogue rather than guessing page numbers. ## Errors and failure paths Plan for these rather than assuming a happy path. **A search with no matches returns a successful result with an empty `productResults` array**, not an error. `requestMetadata.status` is still `ok`. Test the array length before iterating. **An ASIN that does not exist on the chosen marketplace answers with an error, not an empty product.** The same ASIN often exists on one domain and not another, so a failure on `www.amazon.de` does not mean the ASIN is wrong. **A seller ID is marketplace-scoped too.** The ID that a product on `www.amazon.com` returns will not resolve on another domain. **A price can be absent from a live listing.** Items that are out of stock, sold only through other sellers, or gated behind a promotion come back without a usable `currentPrice`. Read `isAvailable` before you compare prices. **`deliveryZip` and `shippingLocation` change the answer, not just the delivery line.** Availability, price and the seller mix all shift with the destination, so a comparison across postcodes has to hold every other parameter still. Results that carry data also carry a `requestMetadata.id` worth quoting in support. ## Pricing, free tier and limits Each Amazon tool costs **5 credits per successful call**. Turning on `otherSellers` adds 5 credits to the product call, 10 instead of 5, so leave it off unless the competing offers are the point. Response size does not change the price. The free tier is **1,000 credits every month with no card**, which is 200 Amazon calls at the base rate. It renews with the billing cycle, so a low-volume agent runs on the free tier indefinitely. Paid plans start at **$49 a month** for 200,000 credits, which is 40,000 calls. The unit price falls with volume, from **$1.23 per 1,000 calls** on the entry plan to **$0.50** on Business, **$0.42** on Growth and **$0.37** on the largest [high-volume plans](https://hasdata.com/prices?utm_source=github&utm_medium=syndication&utm_campaign=amazon-mcp). Your plan also sets concurrency. The free tier allows 1 request at a time, Startup 15, Business 30, Growth 50, and the high-volume plans run from 200 to 1,500. Retry on the 429 with a backoff in anything unattended, because an agent that fans out across ASINs will reach the ceiling before you do. A request that comes back non-200 is not billed. A successful call that finds nothing is still a call. ## Tool selection Two rules cover most of it. Start from what the prompt gives you. A keyword goes to the search tool, an ASIN goes straight to the product tool, and a seller ID goes to one of the two seller tools. Spending a search call to reach an ASIN you already have is the most common waste. Then pick by depth. The search and seller-products tools return the same thin item shape, good for ranking, filtering and price sweeps across many products. The product tool is the only one that returns brand, features, variants, images and the seller, and it is the only one worth calling when the question is about a single item. ## How it compares Amazon's own Product Advertising API is the official route to this data, and it is a different instrument. | | Product Advertising API | This server | | :--- | :--- | :--- | | Eligibility | An approved Associates account with qualifying sales | An API key | | Setup | Associates signup, tag, request signing | One header | | Scope | Items you are approved to ad … ## Source & license This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code. - **Author:** [HasData](https://github.com/HasData) - **Source:** [HasData/amazon-mcp](https://github.com/HasData/amazon-mcp) - **License:** MIT - **Homepage:** https://hasdata.com/apis/amazon-api Install and usage instructions live in the source repository linked above. ## Pricing - **Free** — Free ## Security capabilities Automated source analysis of v0.1.0 — what this tool can access: - **Network access:** no - **Filesystem access:** no - **Shell / process execution:** no - **Environment & secrets:** no - **Dynamic code execution:** no *"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.* ## Versions - **0.1.0** — security scan: passed — Imported from the upstream source. ## Links - Listing page: https://agentstack.voostack.com/l/mcp-hasdata-amazon-mcp - Seller: https://agentstack.voostack.com/s/hasdata - Browse the marketplace: https://agentstack.voostack.com/browse --- Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.