Amazon Seller Operations

1# Amazon Seller Operations
2 
3AI-powered Amazon Seller Central tools for inventory management, fee calculation, and optimization via SP-API.
4 
5mcp-name: io.github.wmarceau/amazon-seller
6 
7## Features
8 
9| Feature | Script | Description |
10|---------|--------|-------------|
11| SP-API Integration | `amazon_sp_api.py` | Core API with caching |
12| FBA Fee Calculator | `amazon_fee_calculator.py` | 2026 fee structure |
13| Inventory Optimizer | `amazon_inventory_optimizer.py` | Restock recommendations |
14| OAuth Authentication | `amazon_oauth_server.py` | OAuth flow handling |
15| MCP Server | `amazon_seller_mcp.py` | MCP protocol wrapper |
16 
17## Directory Structure
18 
19```
20amazon-seller/
21├── src/
22│   ├── amazon_sp_api.py              # Core SP-API client
23│   ├── amazon_fee_calculator.py      # FBA fee calculations
24│   ├── amazon_inventory_optimizer.py # Restock recommendations
25│   ├── amazon_oauth_server.py        # OAuth server
26│   └── ...
27├── mcp-server/
28│   └── amazon_seller_mcp.py          # MCP server wrapper
29├── registry/
30│   └── manifest.json                 # MCP Registry manifest
31├── VERSION                           # Current version
32├── CHANGELOG.md                      # Version history
33├── SKILL.md                          # MCP tool documentation
34└── README.md                         # This file
35```
36 
37## MCP Tools
38 
39| Tool | Description |
40|------|-------------|
41| `get_inventory_summary` | Get FBA inventory levels |
42| `get_orders` | Get recent orders |
43| `get_order_items` | Get order line items |
44| `get_product_details` | Get product info |
45| `calculate_fba_fees` | Calculate comprehensive fees |
46| `estimate_profit_margin` | Quick profit estimation |
47| `suggest_restock_quantities` | Reorder recommendations |
48| `analyze_sell_through_rate` | Sales velocity analysis |
49 
50See [SKILL.md](SKILL.md) for detailed tool documentation.
51 
52## Quick Start
53 
54### 1. Install Dependencies
55```bash
56pip install python-amazon-sp-api python-dotenv mcp
57```
58 
59### 2. Configure Credentials
60Create `.env` file:
61```env
62AMAZON_REFRESH_TOKEN=your_refresh_token
63AMAZON_LWA_APP_ID=your_client_id
64AMAZON_LWA_CLIENT_SECRET=your_client_secret
65AMAZON_AWS_ACCESS_KEY=your_aws_access_key
66AMAZON_AWS_SECRET_KEY=your_aws_secret_key
67AMAZON_ROLE_ARN=arn:aws:iam::123456789:role/your-role
68AMAZON_MARKETPLACE_ID=ATVPDKIKX0DER
69```
70 
71### 3. Test Connection
72```bash
73python src/test_amazon_connection.py
74```
75 
76### 4. Run MCP Server
77```bash
78python mcp-server/amazon_seller_mcp.py
79```
80 
81## CLI Usage
82 
83### Calculate Fees
84```bash
85python src/amazon_fee_calculator.py --asin B08XYZ123 --price 29.99 --cost 10.00
86```
87 
88### Get Inventory Recommendations
89```bash
90python src/amazon_inventory_optimizer.py --asin B08XYZ123 --days 30
91```
92 
93## Key Features
94 
95### 2026 Fee Structure
96- FBA fulfillment fees (size-tier based)
97- Monthly storage fees (seasonal rates)
98- Aged inventory surcharges (12-15mo, 15+mo)
99- Low inventory level fees
100- GET call fee awareness (post April 2026)
101 
102### Caching Layer
103Aggressive caching to minimize API costs:
104- Inventory: 30 min
105- Orders: 15 min
106- Products: 24 hours
107- Fees: 24 hours
108 
109### Multi-Marketplace
110Supports US, CA, MX, BR, UK, DE, FR, IT, ES, NL, JP, SG, AU
111 
112## Version
113 
114Current version: 1.0.0
115 
116## License
117 
118MIT License
119