Amazon Seller MCP Server

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
2. Create an SP-API application (self-authorization)
3. Generate a refresh token via Authorize → Generate refresh token

2. Install

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:

{
  "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