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

hljs language-bash

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

hljs language-bash

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

2. Configure Credentials

Create .env file:

hljs language-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

hljs language-bash

python src/test_amazon_connection.py

4. Run MCP Server

hljs language-bash

python mcp-server/amazon_seller_mcp.py

CLI Usage

Calculate Fees

hljs language-bash

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

Get Inventory Recommendations

hljs language-bash

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

hljs language-bash

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

hljs language-bash

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

2. Configure Credentials

Create .env file:

hljs language-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

hljs language-bash

python src/test_amazon_connection.py

4. Run MCP Server

hljs language-bash

python mcp-server/amazon_seller_mcp.py

CLI Usage

Calculate Fees

hljs language-bash

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

Get Inventory Recommendations

hljs language-bash

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

Amazon Seller Operations

Features

Directory Structure

MCP Tools

Quick Start

1. Install Dependencies

2. Configure Credentials

3. Test Connection

4. Run MCP Server

CLI Usage

Calculate Fees

Get Inventory Recommendations

Key Features

2026 Fee Structure

Caching Layer

Multi-Marketplace

Version

License

Similar Packages

amazon-seller-mcp

Amazon Seller Operations

Features

Directory Structure

MCP Tools

Quick Start

1. Install Dependencies

2. Configure Credentials

3. Test Connection

4. Run MCP Server

CLI Usage

Calculate Fees

Get Inventory Recommendations

Key Features

2026 Fee Structure

Caching Layer

Multi-Marketplace

Version

License

Similar Packages