Amazon Seller MCP

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:

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.