# Amazon Seller MCP Server

MCP (Model Context Protocol) server for managing your Amazon Seller account directly from Claude Code or any MCP-compatible AI assistant.

## Features

**17 tools** for full seller account management:

| Tool | Description |
|------|-------------|
| `amazon_list_marketplaces` | Show all active marketplaces |
| `amazon_switch_marketplace` | Switch between DE, UK, FR, IT, ES, NL, PL, IE, SE, AE, BE |
| `amazon_get_all_listings` | Get all products with details (Reports API) |
| `amazon_get_listing` | Get detailed info for a specific SKU |
| `amazon_search_catalog` | Search Amazon catalog by keywords or ASIN |
| `amazon_create_listing` | Create a new product listing |
| `amazon_update_price` | Update product price |
| `amazon_update_quantity` | Update inventory quantity |
| `amazon_update_listing` | Update title, description, bullet points, etc. |
| `amazon_delete_listing` | Delete/deactivate a listing |
| `amazon_list_orders` | Get orders for the last N days |
| `amazon_get_order` | Get full order details with line items |
| `amazon_get_inventory` | Check FBA and merchant inventory levels |
| `amazon_get_competitive_pricing` | Get competitor pricing for ASINs |
| `amazon_get_fees_estimate` | Estimate Amazon fees for a product |
| `amazon_get_sales_report` | Sales summary report |
| `amazon_upload_document` | Upload GPSR/safety documents |

## Key Design Decisions

- **Auto-detects seller ID** — no need to provide it manually
- **Auto-detects product type** — no hardcoded values when updating listings
- **Structured JSON responses** — all tools return `{success, data, error}` format
- **Error hints** — troubleshooting suggestions for common API errors
- **Multi-marketplace** — switch between 11 EU marketplaces at runtime

## Setup

### 1. Get Amazon SP-API Credentials

1. Register as a developer at [Amazon Developer Central](https://developer.amazonservices.de)
2. Create an SP-API application (self-authorization)
3. Generate a refresh token via **Authorize → Generate refresh token**

### 2. Install

```bash
git clone https://github.com/ArseniiB-o/amazon-seller-mcp.git
cd amazon-seller-mcp
pip install -r requirements.txt
cp .env.example .env
# Edit .env with your credentials
```

### 3. Configure Claude Code

Add to `~/.claude/settings.json`:

```json
{
  "mcpServers": {
    "amazon-seller": {
      "command": "python",
      "args": ["path/to/amazon-seller-mcp/server.py"]
    }
  }
}
```

### 4. Use

Just talk to Claude:

- "Show me all my listings on Amazon"
- "Update the price of SKU K1 to 45 EUR"
- "How many orders did I get this month?"
- "Switch to UK marketplace and show listings there"
- "What are the Amazon fees for ASIN B0H52TPLYQ at 60 EUR?"

## Environment Variables

| Variable | Description |
|----------|-------------|
| `AMAZON_CLIENT_ID` | LWA Client ID (starts with `amzn1.application-oa2-client.xxx`) |
| `AMAZON_CLIENT_SECRET` | LWA Client Secret |
| `AMAZON_REFRESH_TOKEN` | Refresh token (starts with `Atzr\|xxx`) |
| `AMAZON_MARKETPLACE` | Default marketplace code (default: `DE`) |

## Requirements

- Python 3.11+
- Amazon Professional Seller account
- SP-API application with appropriate roles

## License

MIT