# mcp-amazon

Connects coding agents to Amazon Selling Partner API. Enables querying store orders, managing inventory, and updating product listings.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/ecommerce/amazon
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-amazon

## What it does

This server exposes 24 tools for interacting with Amazon SP-API endpoints. It handles seller catalog lookups, listing changes via SKU patches, FBA stock summaries, and order shipment confirmations. Agents can also fetch fee calculations for an ASIN before posting price updates.

Authentication relies on Login with Amazon tokens. The runtime caches temporary credentials in memory after refreshing your long-lived token. Accounts still bound to legacy AWS SigV4 request signatures must supply their own signing wrapper, as this integration supports LWA headers alone.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `AMAZON_LWA_CLIENT_ID`, `AMAZON_LWA_CLIENT_SECRET`, `AMAZON_REFRESH_TOKEN`, `AMAZON_MARKETPLACE_ID`, `AMAZON_REGION`, `AMAZON_SELLER_ID` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env AMAZON_LWA_CLIENT_ID=<AMAZON_LWA_CLIENT_ID> --env AMAZON_LWA_CLIENT_SECRET=<AMAZON_LWA_CLIENT_SECRET> --env AMAZON_REFRESH_TOKEN=<AMAZON_REFRESH_TOKEN> --env AMAZON_MARKETPLACE_ID=<AMAZON_MARKETPLACE_ID> --env AMAZON_REGION=<AMAZON_REGION> --transport stdio amazon -- npx -y @codespar/mcp-amazon
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Codex

**Platform CLI**
```bash
codex mcp add amazon --env AMAZON_LWA_CLIENT_ID=<AMAZON_LWA_CLIENT_ID> --env AMAZON_LWA_CLIENT_SECRET=<AMAZON_LWA_CLIENT_SECRET> --env AMAZON_REFRESH_TOKEN=<AMAZON_REFRESH_TOKEN> --env AMAZON_MARKETPLACE_ID=<AMAZON_MARKETPLACE_ID> --env AMAZON_REGION=<AMAZON_REGION> -- npx -y @codespar/mcp-amazon
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "amazon": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-amazon"
            ],
            "env": {
                "AMAZON_LWA_CLIENT_ID": "<AMAZON_LWA_CLIENT_ID>",
                "AMAZON_LWA_CLIENT_SECRET": "<AMAZON_LWA_CLIENT_SECRET>",
                "AMAZON_REFRESH_TOKEN": "<AMAZON_REFRESH_TOKEN>",
                "AMAZON_MARKETPLACE_ID": "<AMAZON_MARKETPLACE_ID>",
                "AMAZON_REGION": "<AMAZON_REGION>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "amazon": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-amazon"
            ],
            "env": {
                "AMAZON_LWA_CLIENT_ID": "<AMAZON_LWA_CLIENT_ID>",
                "AMAZON_LWA_CLIENT_SECRET": "<AMAZON_LWA_CLIENT_SECRET>",
                "AMAZON_REFRESH_TOKEN": "<AMAZON_REFRESH_TOKEN>",
                "AMAZON_MARKETPLACE_ID": "<AMAZON_MARKETPLACE_ID>",
                "AMAZON_REGION": "<AMAZON_REGION>"
            }
        }
    }
}
```
Replace <…> with your own values. 1 more environment variable is in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e AMAZON_LWA_CLIENT_ID=<AMAZON_LWA_CLIENT_ID> -e AMAZON_LWA_CLIENT_SECRET=<AMAZON_LWA_CLIENT_SECRET> -e AMAZON_REFRESH_TOKEN=<AMAZON_REFRESH_TOKEN> -e AMAZON_MARKETPLACE_ID=<AMAZON_MARKETPLACE_ID> -e AMAZON_REGION=<AMAZON_REGION> amazon npx -y @codespar/mcp-amazon
```
Replace <…> with your own values. 1 more environment variable is in the server README

## When to use it
- fetch customer order records and line items
- update catalog listings by seller SKU
- inspect FBA fulfillable and inbound inventory
- calculate estimated referral and fulfillment fees for an ASIN

## Example prompts
- List recent orders and show line items for the first one
- Estimate referral and FBA fees for ASIN B08N5WRWNW at 29.99
- Run get_inventory_summary to check available FBA stock

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md