amazon-seller-mcp

Amazon Seller Operations

AI-powered Amazon Seller Central tools for inventory management, fee calculation, and optimization via SP-API.

mcp-name: io.github.wmarceau/amazon-seller

Features

| Feature | Script | Description | |---------|--------|-------------| | SP-API Integration | amazon_sp_api.py | Core API with caching | | FBA Fee Calculator | amazon_fee_calculator.py | 2026 fee structure | | Inventory Optimizer | amazon_inventory_optimizer.py | Restock recommendations | | OAuth Authentication | amazon_oauth_server.py | OAuth flow handling | | MCP Server | amazon_seller_mcp.py | MCP protocol wrapper |

Directory Structure

amazon-seller/
├── src/
│   ├── amazon_sp_api.py              # Core SP-API client
│   ├── amazon_fee_calculator.py      # FBA fee calculations
│   ├── amazon_inventory_optimizer.py # Restock recommendations
│   ├── amazon_oauth_server.py        # OAuth server
│   └── ...
├── mcp-server/
│   └── amazon_seller_mcp.py          # MCP server wrapper
├── registry/
│   └── manifest.json                 # MCP Registry manifest
├── VERSION                           # Current version
├── CHANGELOG.md                      # Version history
├── SKILL.md                          # MCP tool documentation
└── README.md                         # This file

MCP Tools

| Tool | Description | |------|-------------| | get_inventory_summary | Get FBA inventory levels | | get_orders | Get recent orders | | get_order_items | Get order line items | | get_product_details | Get product info | | calculate_fba_fees | Calculate comprehensive fees | | estimate_profit_margin | Quick profit estimation | | suggest_restock_quantities | Reorder recommendations | | analyze_sell_through_rate | Sales velocity analysis |

See SKILL.md for detailed tool documentation.

Quick Start

1. Install Dependencies

pip install python-amazon-sp-api python-dotenv mcp

2. Configure Credentials

Create .env file: ``env AMAZON_REFRESH_TOKEN=your_refresh_token AMAZON_LWA_APP_ID=your_client_id AMAZON_LWA_CLIENT_SECRET=your_client_secret AMAZON_AWS_ACCESS_KEY=your_aws_access_key AMAZON_AWS_SECRET_KEY=your_aws_secret_key AMAZON_ROLE_ARN=arn:aws:iam::123456789:role/your-role AMAZON_MARKETPLACE_ID=ATVPDKIKX0DER ``

3. Test Connection

python src/test_amazon_connection.py

4. Run MCP Server

python mcp-server/amazon_seller_mcp.py

CLI Usage

Calculate Fees

python src/amazon_fee_calculator.py --asin B08XYZ123 --price 29.99 --cost 10.00

Get Inventory Recommendations

python src/amazon_inventory_optimizer.py --asin B08XYZ123 --days 30

Key Features

2026 Fee Structure

• FBA fulfillment fees (size-tier based)
• Monthly storage fees (seasonal rates)
• Aged inventory surcharges (12-15mo, 15+mo)
• Low inventory level fees
• GET call fee awareness (post April 2026)

Caching Layer

Aggressive caching to minimize API costs:

• Inventory: 30 min
• Orders: 15 min
• Products: 24 hours
• Fees: 24 hours

Multi-Marketplace

Supports US, CA, MX, BR, UK, DE, FR, IT, ES, NL, JP, SG, AU

Version

Current version: 1.0.0

License

MIT License