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:
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