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