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

Amazon Seller

Installation

Configuration

How to use

README