@striderlabs/mcp-amazon

Amazon MCP Server by Strider Labs — give AI agents the ability to search products, manage your cart, place orders, and track shipments on Amazon via browser automation.

Features

Product Search — search Amazon with full result details (ASIN, price, ratings, Prime badge)
Product Details — fetch complete product info by ASIN or URL
Cart Management — add items, view cart, clear cart
Order Placement — preview and place orders with dual-confirmation safety
Order Tracking — track shipments with status and carrier info
Order History — retrieve past orders
Prime Status — check Prime membership and benefits
Address Management — set delivery address
Session Persistence — cookies saved to ~/.strider/amazon/ across sessions
Stealth Mode — random delays, user agent rotation, webdriver masking to reduce bot detection

Available Tools

Tool	Description
`amazon_status`	Check login status and session info
`amazon_login`	Initiate login flow (returns URL + instructions)
`amazon_logout`	Clear session and cookies
`amazon_search`	Search products by keyword
`amazon_get_product`	Get product details by ASIN or URL
`amazon_add_to_cart`	Add product to cart (ASIN, URL, or query)
`amazon_view_cart`	View cart contents and subtotal
`amazon_clear_cart`	Remove all items from cart
`amazon_preview_order`	Preview order before placing
`amazon_place_order`	Place order (requires `confirm=true`)
`amazon_track_order`	Track order by ID
`amazon_get_orders`	Get order history
`amazon_prime_check`	Check Prime membership status
`amazon_set_address`	Set delivery address

Authentication Flow

Amazon requires manual login (headless browsers cannot complete Amazon's full auth flow including 2FA):

Run amazon_login — it returns https://www.amazon.com/ap/signin
Open that URL in your browser and log in with your Amazon credentials
Complete any 2-factor authentication
Run amazon_status to verify the session is detected
Cookies are saved to ~/.strider/amazon/cookies.json for future sessions

Order Safety

amazon_place_order requires confirm: true to actually place an order:

Without confirm: true — returns a preview (same as amazon_preview_order)
With confirm: true — places the order immediately

Never set confirm: true without explicit user consent.

Bot Detection

Amazon has aggressive bot detection. This server includes:

Random delays between actions (500–2000ms)
User agent rotation (Chrome/Safari on macOS/Windows)
Webdriver property masking
Browser plugin/language spoofing
Proper viewport and screen resolution

If you receive a CAPTCHA error: visit amazon.com in your regular browser, complete the CAPTCHA, then retry. Cookies will be re-used in subsequent calls.

Technical Details

Runtime: Node.js 18+, ES modules
Browser: Playwright Chromium (headless)
Transport: MCP stdio
Session storage: ~/.strider/amazon/

Development

git clone https://github.com/striderlabs/mcp-amazon
cd mcp-amazon
npm install
npx playwright install chromium
npm run build
npm start

Copy & paste — that's it

npm install -g @striderlabs/mcp-amazon

# Install Playwright browsers (required)
npx playwright install chromium

Installation

npm install -g @striderlabs/mcp-amazon

# Install Playwright browsers (required)
npx playwright install chromium

MCP Client Configuration

Claude Desktop (`~/.claude/claude_desktop_config.json`)

{
  "mcpServers": {
    "amazon": {
      "command": "striderlabs-mcp-amazon"
    }
  }
}

Generic MCP Client

{
  "mcpServers": {
    "amazon": {
      "command": "npx",
      "args": ["-y", "@striderlabs/mcp-amazon"]
    }
  }
}

Usage Examples

Search and add to cart

Search for "AirPods Pro" on Amazon
→ amazon_search({ query: "AirPods Pro", maxResults: 5 })

Add the first result to cart
→ amazon_add_to_cart({ asinOrQuery: "B0BDHWDR12", quantity: 1 })

Place an order

Preview my order before placing
→ amazon_preview_order()

Place the order (user must confirm first)
→ amazon_place_order({ confirm: true })

Track a shipment

Track order 123-4567890-1234567
→ amazon_track_order({ orderId: "123-4567890-1234567" })

Configuration

Session data is stored in:

~/.strider/amazon/
├── cookies.json    # Browser session cookies
└── session.json    # Cached session metadata

To reset: run amazon_logout or delete the ~/.strider/amazon/ directory.

Limitations

Requires manual login (no programmatic auth for Amazon)
CAPTCHA challenges must be completed in a real browser
Payment method must be pre-configured on your Amazon account
Amazon's UI changes may break DOM selectors — report issues on GitHub
Not affiliated with Amazon.com, Inc.

Troubleshooting

"CAPTCHA detected" Visit amazon.com in your browser, complete the CAPTCHA, then retry.

"Not logged in" Run amazon_login, open the URL, log in, then run amazon_status.

"Add to Cart button not found" The item may be sold by a third-party seller requiring seller selection, or it may be unavailable. Try amazon_get_product first to verify availability.

"Page load timed out" Check your internet connection. Amazon pages can be slow on first load.

License

MIT — see LICENSE

Built by Strider Labs