@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

Related MCP server: Amazon MCP Server

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"]
    }
  }
}

Available Tools

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" })

Authentication Flow

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

1. Run amazon_login — it returns https://www.amazon.com/ap/signin

2. Open that URL in your browser and log in with your Amazon credentials

3. Complete any 2-factor authentication

4. Run amazon_status to verify the session is detected

5. Cookies are saved to ~/.strider/amazon/cookies.json for future sessions

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.

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/

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.

Development

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

License

MIT — see LICENSE

Built by Strider Labs