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

Metadata

Release files for amazon-seller-mcp 1.0.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for amazon-seller-mcp 1.0.1
File	Size	Uploaded	Provenance	Actions
amazon_seller_mcp-1.0.1.tar.gz	41.3 kB	Oct 9, 2026	Without provenance	Details for amazon_seller_mcp-1.0.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for amazon-seller-mcp 1.0.1
File	Interpreter	ABI	Platform	Actions Reset
amazon_seller_mcp-1.0.1-py3-none-any.whl 20.9 kB Oct 9, 2026 Without provenance	Python 3	none	any	Details for amazon_seller_mcp-1.0.1-py3-none-any.whl

Total release size: 62.2 kB

Release files / amazon_seller_mcp-1.0.1.tar.gz

Download URL	amazon_seller_mcp-1.0.1.tar.gz
Size	41.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`00f05bb983972b9c2cbcc422e4b1764ac97c56bfddbd09544046e4557c24b597`
BLAKE2b-256 checksum How to use checksums	`c74ae82adfde6019b8de405338932fa21d0a1efffee0e0f38e293cb868a1db80`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.5`

Release files / amazon_seller_mcp-1.0.1-py3-none-any.whl

Download URL	amazon_seller_mcp-1.0.1-py3-none-any.whl
Size	20.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`d9ce26daa35222633109b55e74a46167514d3c67304cd4e2fe926ef25527260d`
BLAKE2b-256 checksum How to use checksums	`888d7336ba14e1f49650c8c64c474663c348de92fbcd8ea6d67636192060db6f`
Upload date	Oct 9, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.13.5`

Security for amazon-seller-mcp 1.0.1

Report project as malware

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.0.1 This release

Oct 9, 2026 2 release files No provenance

1.0.0

Jan 14, 2026 2 release files No provenance

amazon-seller-mcp 1.0.1