Amazon MCP server for your agent
To give Claude, Cursor, ChatGPT or another MCP client Amazon data, add Apify's hosted MCP server with the Actors ticked below as tools (6 by default); the URL is in every config. Sign in with your Apify account or pass an API token; each call runs the Actor and returns Amazon records to the agent.
One click, signs in with Apify on first use:
Any other client, one command (writes the config for 25+ agents, including Windsurf, Zed, Cline and Goose):
npx add-mcp "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/amazon-multi-domain-product-price-and-detail,dataspryva/amazon-search-category-and-seller-listings,vexaloom-labs/amazon-customer-review-and-rating-summary-scraper,nimbryxo-studio/amazon-best-sellers-and-rankings-scraper,nimbryxo-studio/amazon-all-offers-and-buy-box-tracker,dataspryva/amazon-deals-grid-tracker-by-category-and-discount" --name apify-amazon - Catalogue Actors
- 12
- In this bundle
- 6
- Official API
- Limited
- Data checked
- 2026-11-12
Config for your client
Claude Code configterminal or .mcp.json
claude mcp add --transport http apify-amazon "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/amazon-multi-domain-product-price-and-detail,dataspryva/amazon-search-category-and-seller-listings,vexaloom-labs/amazon-customer-review-and-rating-summary-scraper,nimbryxo-studio/amazon-best-sellers-and-rankings-scraper,nimbryxo-studio/amazon-all-offers-and-buy-box-tracker,dataspryva/amazon-deals-grid-tracker-by-category-and-discount" - Run the command in your project folder. Add --scope user to make it available in every project.
- Start Claude Code, type /mcp, pick the server and sign in to Apify in the browser window.
- No browser sign-in? Add --header "Authorization: Bearer YOUR_APIFY_TOKEN" to the command instead.
Sign-in: OAuth sign-in on first use, or a token header.
Claude Desktop configclaude_desktop_config.json
{
"mcpServers": {
"apify-amazon": {
"command": "npx",
"args": [
"-y",
"@apify/actors-mcp-server",
"--tools",
"fetch-actor-details,nimbryxo-studio/amazon-multi-domain-product-price-and-detail,dataspryva/amazon-search-category-and-seller-listings,vexaloom-labs/amazon-customer-review-and-rating-summary-scraper,nimbryxo-studio/amazon-best-sellers-and-rankings-scraper,nimbryxo-studio/amazon-all-offers-and-buy-box-tracker,dataspryva/amazon-deals-grid-tracker-by-category-and-discount"
],
"env": {
"APIFY_TOKEN": "YOUR_APIFY_TOKEN"
}
}
}
} - Easiest: open Customize, then Connectors, choose Add custom connector, paste the server URL (the ChatGPT tab shows it on its own) and sign in to Apify.
- Local alternative (needs Node.js): merge this into claude_desktop_config.json (Settings, Developer, Edit config) and replace YOUR_APIFY_TOKEN.
- Restart Claude Desktop and enable the server from the tools menu in a chat.
Sign-in: Connector with OAuth, or a token in the local config.
Cursor config~/.cursor/mcp.json
{
"mcpServers": {
"apify-amazon": {
"url": "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/amazon-multi-domain-product-price-and-detail,dataspryva/amazon-search-category-and-seller-listings,vexaloom-labs/amazon-customer-review-and-rating-summary-scraper,nimbryxo-studio/amazon-best-sellers-and-rankings-scraper,nimbryxo-studio/amazon-all-offers-and-buy-box-tracker,dataspryva/amazon-deals-grid-tracker-by-category-and-discount",
"headers": {
"Authorization": "Bearer ${env:APIFY_TOKEN}"
}
}
}
} - Save as ~/.cursor/mcp.json for every project, or .cursor/mcp.json for one project. Merge with servers you already have.
- Set APIFY_TOKEN in the environment Cursor starts from, or replace ${env:APIFY_TOKEN} with your token.
- Open Cursor Settings, then MCP, and check that the server lists its tools.
Sign-in: Token read from the APIFY_TOKEN environment variable.
VS Code config.vscode/mcp.json
{
"inputs": [
{
"type": "promptString",
"id": "apify-token",
"description": "Apify API token",
"password": true
}
],
"servers": {
"apify-amazon": {
"type": "http",
"url": "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/amazon-multi-domain-product-price-and-detail,dataspryva/amazon-search-category-and-seller-listings,vexaloom-labs/amazon-customer-review-and-rating-summary-scraper,nimbryxo-studio/amazon-best-sellers-and-rankings-scraper,nimbryxo-studio/amazon-all-offers-and-buy-box-tracker,dataspryva/amazon-deals-grid-tracker-by-category-and-discount",
"headers": {
"Authorization": "Bearer ${input:apify-token}"
}
}
}
} - Save as .vscode/mcp.json in your workspace.
- Start the server from the file or the MCP servers view. VS Code asks for the token once and stores it securely.
- Use the tools from Copilot Chat in agent mode.
Sign-in: Token prompted once and stored by VS Code.
ChatGPT configPlugins > Add custom MCP server
https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/amazon-multi-domain-product-price-and-detail,dataspryva/amazon-search-category-and-seller-listings,vexaloom-labs/amazon-customer-review-and-rating-summary-scraper,nimbryxo-studio/amazon-best-sellers-and-rankings-scraper,nimbryxo-studio/amazon-all-offers-and-buy-box-tracker,dataspryva/amazon-deals-grid-tracker-by-category-and-discount - In ChatGPT on the web, open Plugins, select + and choose Add custom MCP server.
- Name it, paste the URL under Connection as the Server URL and choose OAuth for authentication.
- Accept the risk warning (I understand and want to continue), select Create as a plugin, then install the plugin from your plugins, sign in to Apify and use it in a new chat.
Sign-in: OAuth sign-in with your Apify account.
Codex CLI config~/.codex/config.toml
[mcp_servers.apify-amazon]
url = "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/amazon-multi-domain-product-price-and-detail,dataspryva/amazon-search-category-and-seller-listings,vexaloom-labs/amazon-customer-review-and-rating-summary-scraper,nimbryxo-studio/amazon-best-sellers-and-rankings-scraper,nimbryxo-studio/amazon-all-offers-and-buy-box-tracker,dataspryva/amazon-deals-grid-tracker-by-category-and-discount"
bearer_token_env_var = "APIFY_TOKEN" - Add the block to ~/.codex/config.toml, or .codex/config.toml in a project.
- Export APIFY_TOKEN in the shell that starts Codex. Or skip the token line and run codex mcp login to sign in.
- Start codex and type /mcp to check that the tools are listed.
Sign-in: Token read from the APIFY_TOKEN environment variable.
Gemini CLI configterminal (writes ~/.gemini/settings.json)
gemini mcp add -t http -s user -H "Authorization: Bearer $APIFY_TOKEN" apify-amazon "https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/amazon-multi-domain-product-price-and-detail,dataspryva/amazon-search-category-and-seller-listings,vexaloom-labs/amazon-customer-review-and-rating-summary-scraper,nimbryxo-studio/amazon-best-sellers-and-rankings-scraper,nimbryxo-studio/amazon-all-offers-and-buy-box-tracker,dataspryva/amazon-deals-grid-tracker-by-category-and-discount" - Export APIFY_TOKEN first: the shell expands it and Gemini CLI saves the header, token included, in plain text in ~/.gemini/settings.json (keep that file private). In PowerShell write $env:APIFY_TOKEN instead of $APIFY_TOKEN. Drop -s user to save it in the project's .gemini/settings.json.
- Start gemini and type /mcp to check that the server is connected and lists its tools.
- Saved by hand, a remote server uses the httpUrl key for streamable HTTP (url means the older SSE transport).
Sign-in: Token header saved by gemini mcp add.
n8n AI Agent configMCP Client Tool node
https://mcp.apify.com/?tools=fetch-actor-details,nimbryxo-studio/amazon-multi-domain-product-price-and-detail,dataspryva/amazon-search-category-and-seller-listings,vexaloom-labs/amazon-customer-review-and-rating-summary-scraper,nimbryxo-studio/amazon-best-sellers-and-rankings-scraper,nimbryxo-studio/amazon-all-offers-and-buy-box-tracker,dataspryva/amazon-deals-grid-tracker-by-category-and-discount - Add an AI Agent node, then attach an MCP Client Tool node to its tool input.
- Paste the URL as the endpoint and choose HTTP Streamable as the transport.
- Choose Bearer auth and create a credential that holds your Apify token.
Sign-in: Bearer auth credential.
Validated, not executed: 7 of 7 checks pass
- Uses Apify's hosted MCP endpoint over HTTPS
- The tools parameter lists exactly the chosen Actors as owner/name
- JSON configs parse and use the client's top-level key and the same URL
- Codex TOML has a [mcp_servers.<name>] table with url and bearer_token_env_var
- CLI commands quote the same URL and use the streamable HTTP transport
- One-click install links decode back to the same URL and carry no token
- Only placeholders, no real token
Official API or an Actor?
Amazon has an official API with limited access
Product Advertising API 5 is deprecated: calls now return HTTP 403 with a message to migrate to the Creators API, its successor for catalog data (SearchItems, GetItems, GetVariations, GetBrowseNodes). The Selling Partner API serves authorized sellers. Neither is an open general-purpose retail data API.
No per-call price is published for the Creators API.
Creators API access requires enrolment in the Amazon Associates program for the marketplace and at least 10 qualifying sales in the past 30 days, then registration in Associates Central.
Amazon Creators API (replaced the Product Advertising API) and Selling Partner API documentation
Public product data only; respect Amazon's conditions of use; not legal advice.
Which Actor for which job
- Amazon Deals Grid Tracker by Category & Discount collects discounted products from the deals grid; it returns
dealPriceanddealEndsAt. - Amazon Multi-Domain Product Price & Detail Scraper retrieves product, search-result and chart-entry details across Amazon marketplaces; it returns
priceandinStock. - Amazon All Offers & Buy Box Tracker compares seller offers for a product; it returns
conditionandsoldBy. - Amazon Autocomplete Keyword Expander builds search-suggestion lists from seed terms; it returns
suggestionandvolumeProxy. - Amazon rankings scraper collects entries from sales, new-release, gifting and other ranked charts; it returns
rankandchartType. - Amazon Brand Store Page & Merchandising Crawler maps brand-store pages and merchandising sections; it returns
pageNameandsectionType. - Amazon Creator Storefront & Idea List Scraper collects creator profiles, curated lists and shoppable content; it returns
handleandrecordType.
Where it stops
The token-based configurations require your Apify API token, which authorizes Apify access rather than Amazon OAuth, seller access or an Amazon account session. Recipe for Agents has not authenticated to Apify or Amazon for you. Returned records follow each Actor’s published schema; missing values and explicit error rows need to remain visible in downstream summaries. For approved Amazon Associates catalog use, choose the Product Advertising API; for authorized seller operations, choose the Selling Partner API.
Every Amazon Actor in the catalogue
| Actor | Returns | Fields | Store price | Last update |
|---|---|---|---|---|
| Amazon Review Aggregates & Extended History Scraper | One record per collected Amazon customer review — rating, title, body, verified-purchase/Vine flags, helpful-votes count, reviewer… Fields include productAsin, reviewedProductAsin, ratingScore. | 28 | $0.99 per 1,000 results | 2026-10-31 |
| Amazon Deals Grid Tracker by Category & Discount | One record per discounted product on Amazon's Today's Deals grid: ASIN, title, images, local-currency deal/list price, savings, rating and… Fields include asin, title, dealPrice. | 8 | $0.99 per 1,000 results | 2026-10-26 |
| Amazon Multi-Domain Product Price & Detail Scraper | One record per product, search result, or bestseller entry, plus explicit error rows. Fields include ASIN/parent ASIN, price/list… Fields include title, asin, price. | 9 | $0.99 per 1,000 results | 2026-11-04 |
| Amazon All Offers & Buy Box Tracker | Per-seller offers for scraped Amazon ASINs -- condition (+ normalized condition bucket, + seller-provided condition note on used offers)… Fields include productAsin, offerPosition, condition. | 10 | $0.99 per 1,000 results | 2026-11-10 |
| Amazon Autocomplete Keyword Expander | Amazon search-autocomplete keyword suggestions with marketplace, department, expansion lineage, relative volume proxy, search URLs… Fields include seedKeyword, suggestion, volumeProxy. | 6 | $0.99 per 1,000 results | 2026-11-05 |
| Amazon Best Sellers & Rankings Scraper | Ranked chart items from Amazon's Best Sellers, New Releases, Most Wished For, Most Gifted, and Movers & Shakers pages -- authoritative… Fields include asin, title, brand. | 28 | $0.99 per 1,000 results | 2026-11-06 |
| Amazon Brand Store Page & Merchandising Crawler | One dataset of typed records: store pages (identity, navigation, counts), merchandising sections (type, heading, CTA, media, counts)… Fields include brand, pageName, asin. | 11 | $0.99 per 1,000 results | 2026-11-07 |
| Amazon Creator Storefront & Idea List Scraper | Amazon influencer storefront records: shop profiles, Idea List summaries and products, creator videos, shoppable photos, curations, and… Fields include handle, displayName, title. | 11 | $0.99 per 1,000 results | 2026-11-11 |
| Amazon Search, Category & Seller Listings Extractor | Amazon product records from search, category, and seller listings with price, rating, badges, and delivery details. Fields include title, asin, price. | 8 | $0.99 per 1,000 results | 2026-11-04 |
| Amazon Third-Party Seller Profile & Storefront Catalog | Seller profile records (logo, business name/address/phone, ratings, feedback windows, histogram, recent individual feedback entries)… Fields include sellerId, sellerName, title. | 9 | $0.99 per 1,000 results | 2026-11-11 |
| Amazon Wishlist & Registry Scraper | List metadata (recordType=list: title, owner, description, event date/location, counts, access classification) and list-item records… Fields include title, accessClassification, asin. | 11 | $0.99 per 1,000 results | 2026-11-08 |
| Amazon Customer Review & Rating Summary Scraper | One record per Amazon customer review (rating, text, verified/Vine flags, helpful votes, variant, media, dates, source metadata) plus one… Fields include productAsin, ratingScore, reviewTitle. | 28 | $0.99 per 1,000 results | 2026-11-06 |
Call these Actors from code: the Amazon data API page
Store links: amazon-review-aggregates-and-extended-history, amazon-deals-grid-tracker-by-category-and-discount, amazon-multi-domain-product-price-and-detail, amazon-all-offers-and-buy-box-tracker, amazon-autocomplete-keyword-expander, amazon-best-sellers-and-rankings-scraper, amazon-brand-store-page-and-merchandising-crawler, amazon-creator-storefront-and-idea-list-scraper, amazon-search-category-and-seller-listings, amazon-third-party-seller-profile-and-storefront, amazon-wishlist-and-registry-scraper, amazon-customer-review-and-rating-summary-scraper
Amazon recipes for n8n
Amazon prices to Google Sheets
Log the price, rating and stock of the Amazon products you watch in a Google Sheet every day.
AmazonGoogle SheetsAmazon reviews to Google Sheets
Collect public Amazon review data for a product search and export the themes and ratings to a Sheet.
AmazonGoogle Sheets
Troubleshooting
Why does the client say Unauthorized or invalid token?
Every Apify Actor tool needs a signed-in Apify account. Reconnect the server so the OAuth sign-in runs again, or switch to the token variant: an Authorization: Bearer header with an API token from Apify Console, Settings, API and integrations. For a local server the token must be in the server's own env block, not only in your shell.
Source: Apify MCP server README
Why did my agent's tool list change after an update?
Without a tools parameter Apify's server loads its default tool set, which changes between releases. The URLs on this site pin the tools with ?tools=, so the agent always gets the same Actor tool plus fetch-actor-details. Apify's README gives the same advice for production.
Source: Apify MCP server README
What happens when the agent sends input the Actor rejects?
The server answers with the Actor's input schema, so the agent can fix the arguments and call again. The fetch-actor-details tool in every scoped URL lets it read that schema before the first call.
Source: Apify MCP server README
Claude Code shows Needs authentication. Why?
The server is added but not signed in. Type /mcp in an interactive session and authenticate, or run claude mcp login with the server name. Headless runs with claude -p cannot complete OAuth, so sign in once interactively or use the --header token variant.
Source: Claude Code MCP documentation
Claude Code warns that a tool result is too large. What can I change?
Claude Code warns above 10,000 tokens of tool output and caps it at 25,000 by default (MAX_MCP_OUTPUT_TOKENS raises it). Ask the agent for fewer results per call, for example a lower result limit for the Actor.
Source: Claude Code MCP documentation
Cursor does not show the server's tools. What should I check?
Open the Output panel and pick MCP Logs to see the connection error. A deeplink install that does nothing usually means an older Cursor build; update it or paste the JSON into mcp.json by hand.
Source: Cursor MCP documentation
Questions
How do I get Amazon product data into Claude?
Add the Apify MCP configuration for your Claude client and complete Apify authentication using the method that configuration requires. Ask Claude to inspect the selected Actor’s published schema before collecting products, reviews or offers.
Can you compare Amazon sellers for the same product?
Choose Amazon All Offers & Buy Box Tracker to collect seller offers for the target product. Its price and soldBy values support comparisons between the offers returned.
Does connecting this give Claude access to my Amazon account?
An Apify API token authorizes access to Apify, not your Amazon account. Connecting the MCP server does not complete Amazon OAuth or authorize seller operations.
Can you collect Amazon brand stores and creator lists too?
Add Amazon Brand Store Page & Merchandising Crawler or Amazon Creator Storefront & Idea List Scraper to the MCP tool list before requesting those jobs. The brand-store Actor returns sectionType, while the creator-storefront Actor returns handle.
Sources
- Apify MCP server documentation, checked 2026-11-10
- Amazon Creators API (replaced the Product Advertising API) and Selling Partner API documentation, checked 2026-11-12
- affiliate-program.amazon.com/creatorsapi/docs/en-us/paapiv5-deprecation, checked 2026-11-12
- Amazon terms