About MarceauSolutions/amazon-seller-mcp
MarceauSolutions/amazon-seller-mcp is an MCP server published by MarceauSolutions in the Commerce category: amazon Seller Central operations via SP-API - MCP server for Claude Desktop.
The repository has 6 stars and 5 forks, with the last commit 9 months ago. Six months or more without a commit doesn't mean the server is broken, but check the open issues before depending on it in production.
Install
git clone https://github.com/MarceauSolutions/amazon-seller-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (8)
analyze_sell_through_rateSales velocity analysis
Parameters not published.
calculate_fba_feesCalculate comprehensive fees
Parameters not published.
estimate_profit_marginQuick profit estimation
Parameters not published.
get_inventory_summaryGet FBA inventory levels
Parameters not published.
get_order_itemsGet order line items
Parameters not published.
get_ordersGet recent orders
Parameters not published.
get_product_detailsGet product info
Parameters not published.
suggest_restock_quantitiesReorder recommendations
Parameters not published.
Ask AI
Ask AI about MarceauSolutions/amazon-seller-mcp
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 6 hours ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- !Tests presentNo tests found. Behaviour changes may go unnoticed between versions.
- !Dependencies pinnedNo lockfile. Installs can pull different code over time.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
README
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
README fetched from the repository 6 hours ago. The original is authoritative.