amazon-business-mcp-browser
Provides tools for searching products, viewing product details, managing the Amazon cart (add, update quantity, remove items), and preparing checkout on an Amazon Business account via a visible browser session.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@amazon-business-mcp-browser Search for 'paper shredder' and show the results with prices"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Amazon Business MCP Browser
Server MCP locale per cercare prodotti e gestire un carrello Amazon Business tramite un browser Playwright visibile e isolato.
Stato: prototipo iniziale. Amazon non supporta ufficialmente questa automazione del sito. L'interfaccia può cambiare, comparire CAPTCHA o richiedere nuovamente MFA. Verifica che l'uso sia compatibile con le condizioni applicabili al tuo account.
Principi di sicurezza
Il login avviene personalmente nella finestra Amazon: l'MCP non chiede né conserva la password.
La sessione risiede in un profilo browser locale dedicato, fuori dal repository.
Il browser resta visibile (
headless: false).Le operazioni browser sono serializzate per evitare modifiche concorrenti al carrello.
amazon_prepare_checkoutapre solo la revisione del carrello.Non esiste un tool che prema Effettua l'ordine.
Related MCP server: grocery-mcp
Tool disponibili
Tool | Effetto |
| Controlla lo stato indicativo della sessione |
| Apre il login per completamento manuale |
| Cerca prodotti e prezzi visibili all'account |
| Legge i dettagli di un ASIN |
| Legge il carrello reale |
| Aggiunge un articolo |
| Aggiorna quantità; zero rimuove |
| Rimuove un articolo |
| Porta alla revisione manuale, senza acquistare |
Requisiti
Node.js 20 o successivo
Account Amazon Business
macOS, Linux o Windows con interfaccia grafica
Installazione
npm install
npx playwright install chromium
npm run buildPer usare Google Chrome installato anziché il Chromium incluso:
export AMAZON_BROWSER_CHANNEL=chromeConfigurazione MCP
Esempio generico per un client MCP:
{
"mcpServers": {
"amazon-business": {
"command": "node",
"args": ["/percorso/amazon-business-mcp-browser/dist/index.js"],
"env": {
"AMAZON_MARKETPLACE_URL": "https://www.amazon.it",
"AMAZON_BROWSER_CHANNEL": "chromium"
}
}
}
}Al primo utilizzo:
Chiama
amazon_open_login.Completa login, MFA ed eventuale CAPTCHA nella finestra aperta.
Chiama
amazon_session_status.Avvia una ricerca o leggi il carrello.
Il profilo predefinito viene salvato in ~/.amazon-business-mcp-browser/profile. Puoi cambiarlo con AMAZON_BROWSER_PROFILE.
Configurazione
Copia .env.example come riferimento. Il server legge direttamente le variabili d'ambiente:
Variabile | Default | Descrizione |
|
| Marketplace autorizzato |
| profilo sotto la home | Directory sessione isolata |
|
|
|
|
| Timeout browser |
|
| Massimo risultati, da 1 a 20 |
Sviluppo
npm run check
npm test
npm run buildI test automatici non effettuano accessi né modifiche su Amazon. Le verifiche end-to-end devono essere eseguite manualmente su un account autorizzato.
Limiti noti
Selettori, testi e flussi Amazon possono cambiare senza preavviso.
CAPTCHA, MFA e consensi devono essere completati manualmente.
Alcuni prodotti richiedono la selezione di una variante prima di poterli aggiungere.
Prezzi e disponibilità sono istantanee e possono cambiare durante il checkout.
Non aggira protezioni anti-bot, limiti dell'account o controlli Amazon.
Evoluzione prevista
Il codice browser è separato dal layer MCP per consentire in futuro un provider basato sulle API ufficiali Amazon Business, mantenendo invariati i nomi dei tool.
Available Tools
9 toolsamazon_add_to_cartAggiungi al carrello AmazonB
Aggiunge un ASIN al carrello reale. È un'azione modificante ma non effettua acquisti.
Inputs: asin (required), quantity.
amazon_get_cartLeggi carrello AmazonA
Restituisce un'istantanea del carrello Amazon reale con timestamp.
Inputs: no named parameters.
amazon_open_loginApri login AmazonA
Apre Amazon in un browser visibile. L'utente inserisce personalmente password, MFA e CAPTCHA.
Inputs: no named parameters.
amazon_prepare_checkoutPrepara revisione checkoutA
Porta il browser al carrello e restituisce il riepilogo. Non effettua né conferma l'ordine.
Inputs: no named parameters.
amazon_product_detailsDettagli prodotto AmazonA
Legge titolo, prezzo, disponibilità, venditore e caratteristiche di un ASIN.
Inputs: asin (required).
amazon_remove_from_cartRimuovi dal carrello AmazonC
Rimuove un ASIN dal carrello reale.
Inputs: asin (required).
amazon_searchCerca su Amazon BusinessA
Cerca prodotti nel marketplace Amazon configurato usando la sessione Business del browser.
Inputs: query (required), limit.
amazon_session_statusStato sessione AmazonA
Controlla se il profilo browser isolato risulta autenticato su Amazon.
Inputs: no named parameters.
amazon_update_quantityModifica quantità nel carrelloA
Aggiorna la quantità di un ASIN nel carrello. Quantità zero rimuove l'articolo.
Inputs: asin (required), quantity (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool has a clearly distinct purpose: session status, product details, login, search, cart snapshot, checkout prep, and cart mutations. The only slight overlap is between get_cart and prepare_checkout, but their descriptions clearly differentiate a snapshot from an actionable step.
All tools use the consistent 'amazon_' prefix, and most follow a verb_noun pattern (get_cart, add_to_cart, update_quantity, remove_from_cart, open_login, prepare_checkout). However, 'session_status' and 'product_details' are noun phrases rather than verb-first, creating a minor stylistic deviation that is still readable and predictable.
The 9 tools are well-scoped for a browser-based Amazon Business assistant, covering authentication, product search, cart management, and checkout preparation. The count feels neither sparse nor bloated for the intended functionality.
The tool set covers the full cart CRUD lifecycle (add, get, update, remove) plus search and product details. However, the checkout flow ends at preparation and never confirms an order, leaving a notable gap for fully automated purchasing. There is also no order history or account management, but that may be intentional for safety.
Maintenance
Related MCP Connectors
Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
Hosted Shopify MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted MCP for e-commerce: live product catalog, stock, and pricing for AI agents.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceAn MCP server that enables AI assistants to browse, analyze, and automate interactions with wholesale websites using Playwright and recipe-based HTTP execution. It supports tasks like automated login, product searching, and cart management through browser snapshots and network log analysis.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for grocery-related web automation using Playwright, enabling AI assistants to interact with grocery websites.ISC
- AlicenseBqualityDmaintenanceAn MCP server for generic browser automation using Playwright. Enables MCP clients to navigate pages, inspect elements, execute JavaScript, capture screenshots, and monitor console logs and network traffic via a headless Chromium instance.7ISC
- AlicenseAqualityDmaintenanceA local AI shopping MCP server for Amazon.co.jp that searches products, adds them to cart, and opens the review page without automating purchase confirmation. It keeps your Amazon login confined to your machine's Chrome profile.5MIT