# MarceauSolutions/amazon-seller-mcp [Health: Active]

**Category:** 🏢 Workplace & Productivity  
**Repository:** https://github.com/MarceauSolutions/amazon-seller-mcp  
**GitHub Stars:** 6  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/marceausolutions-amazon-seller-mcp

## Description
Amazon Seller Central operations via SP-API - manage inventory, track orders, analyze sales, and optimize listings

## Tools
Capabilities this server exposes over MCP:

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

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

```json
"mcpServers": {
  "amazon-seller-mcp": {
    "command": "uvx",
    "args": ["python-amazon-sp-api"],
    "env": {
      "AMAZON_REFRESH_TOKEN": "",
      "AMAZON_LWA_APP_ID": "",
      "AMAZON_LWA_CLIENT_SECRET": "",
      "AMAZON_AWS_ACCESS_KEY": "",
      "AMAZON_AWS_SECRET_KEY": "",
      "AMAZON_ROLE_ARN": "",
      "AMAZON_MARKETPLACE_ID": ""
    }
  }
}
```

**Requires environment variables:** `AMAZON_REFRESH_TOKEN`, `AMAZON_LWA_APP_ID`, `AMAZON_LWA_CLIENT_SECRET`, `AMAZON_AWS_ACCESS_KEY`, `AMAZON_AWS_SECRET_KEY`, `AMAZON_ROLE_ARN`, `AMAZON_MARKETPLACE_ID` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What MarceauSolutions/amazon-seller-mcp MCP server does

MarceauSolutions/amazon-seller-mcp MCP server provides Amazon Seller Central operations through the Selling Partner API (SP-API). It is intended for sellers or agents that need to inspect fulfillment-by-Amazon inventory, retrieve order data, examine product information, and perform operational calculations without building each request directly against SP-API.

The available tools cover both data retrieval and seller analysis. Inventory and order tools read operational data, while fee, margin, restock, and sell-through tools turn seller inputs or API data into planning metrics.

## How it works

The project includes an SP-API client, an OAuth component, fee calculation code, an inventory optimization module, and an MCP protocol wrapper. The MCP entry point is `mcp-server/amazon_seller_mcp.py`. After credentials and marketplace settings are provided, an MCP client can call the exposed tools.

The README describes a caching layer with different intervals by data type: inventory is cached for 30 minutes, orders for 15 minutes, and product and fee data for 24 hours. The stated purpose is to reduce repeated API calls. Supported marketplaces include US, CA, MX, BR, UK, DE, FR, IT, ES, NL, JP, SG, and AU.

## Setup and configuration

The documented setup installs the Python dependencies with:

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

The server requires these environment variables:

- `AMAZON_REFRESH_TOKEN`
- `AMAZON_LWA_APP_ID`
- `AMAZON_LWA_CLIENT_SECRET`
- `AMAZON_AWS_ACCESS_KEY`
- `AMAZON_AWS_SECRET_KEY`
- `AMAZON_ROLE_ARN`
- `AMAZON_MARKETPLACE_ID`

The README shows the server being started with `python mcp-server/amazon_seller_mcp.py`. It also provides a separate connection test at `python src/test_amazon_connection.py`.

## Tools and capabilities

MarceauSolutions/amazon-seller-mcp MCP server exposes these tools:

- `get_inventory_summary` retrieves FBA inventory levels.
- `get_orders` retrieves recent orders.
- `get_order_items` retrieves line items for orders.
- `get_product_details` retrieves product information.
- `calculate_fba_fees` calculates comprehensive FBA fees.
- `estimate_profit_margin` provides a quick profit estimate.
- `suggest_restock_quantities` recommends reorder quantities.
- `analyze_sell_through_rate` analyzes sales velocity.

The README identifies the fee calculator as covering the 2026 fee structure, including size-tier fulfillment fees, seasonal monthly storage rates, aged inventory surcharges, low-inventory-level fees, and awareness of GET call fees after April 2026.

## Limitations and notes

The supplied material does not document tool argument schemas, response formats, pagination behavior, error handling, or the exact OAuth consent flow. It also does not state whether every marketplace supports every operation. Amazon credentials, AWS access details, an IAM role, and a marketplace ID must be configured before the server can access seller data. The listed version is 1.0.0, and the project is released under the MIT License.

_Full upstream README: https://allmcps.com/mcp/marceausolutions-amazon-seller-mcp/readme_