amazon-sp-mcp

Overview

This MCP server enables natural language interactions with Amazon Seller Central through the SP-API. It provides comprehensive access to order information, inventory management, sales metrics, financial reports, and analytics data. The implementation uses only LWA OAuth 2.0 authentication, eliminating the need for AWS credentials. The server includes robust rate limiting, comprehensive error handling, and supports multiple Amazon marketplaces across North America, Europe, and the Far East.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_orders

  List orders by date range, status, fulfillment channel

  Try:Get my orders from last weekTry:Show me pending FBA orders
• get_order_details

  Get details for a specific order

  Try:Show me details for order 123-4567890Try:What items are in order 902-9876543
• get_order_items

  Get line items for an order

  Try:List items in order 123-4567890Try:What products were in my latest order
• get_inventory_summary

  FBA inventory levels and health

  Try:What's my current inventory statusTry:Show me my FBA inventory levels
• get_fba_inventory_details

  Detailed breakdown of reserved/unfulfillable quantities

  Try:Show me detailed inventory healthTry:Which SKUs are unfulfillable
• get_sales_metrics

  Sales aggregates by day/week/month

  Try:What were my sales last monthTry:Show weekly sales averages
• get_fba_reimbursements

  Lost/damaged inventory reimbursements

  Try:Show me FBA reimbursements for JanuaryTry:What reimbursements do I have for lost items
• get_settlement_report

  Payment disbursement details

  Try:Pull my settlement reportTry:Show me last payment breakdown
• get_fba_fee_estimates

  Per-SKU fee breakdown

  Try:What are my FBA fees by SKUTry:Show fee estimates for my inventory
• get_storage_fees

  Monthly storage charges

  Try:What are my storage fees this monthTry:Show me storage charges by SKU
• get_longterm_storage_fees

  LTSF for aged inventory (365+ days)

  Try:Show my long-term storage feesTry:Which items have been in storage over a year
• get_sales_traffic_report

  Sessions, page views, conversion rates

  Try:Show me my sales traffic metricsTry:What's my conversion rate for last month

Comparable tools

Installation

# Clone and install
git clone https://github.com/mansournorouzi/amazon-sp-mcp.git
cd amazon-sp-mcp
npm install
npm run build

# Configure credentials
cp .env.example .env
# Edit .env with your LWA credentials, Seller ID, Marketplace ID

# For Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
```json
{
  "mcpServers": {
    "amazon-seller": {
      "command": "node",
      "args": ["/path/to/amazon-sp-mcp/build/index.js"],
      "env": {
        "LWA_CLIENT_ID": "amzn1.application-oa2-client.xxxxx",
        "LWA_CLIENT_SECRET": "your_secret",
        "LWA_REFRESH_TOKEN": "Atzr|your_token",
        "SELLER_ID": "your_seller_id",
        "MARKETPLACE_ID": "ATVPDKIKX0DER",
        "SP_API_ENDPOINT": "https://sellingpartnerapi-na.amazon.com"
      }
    }
  }
}

FAQ

What authentication method does this server use?

The server uses only LWA (Login with Amazon) OAuth 2.0 authentication, and does not require AWS credentials or IAM setup.

Which Amazon marketplaces are supported?

The server supports all major Amazon marketplaces including North America, Europe, and the Far East regions, with configurable endpoints for each region.

Compare amazon-sp-mcp with