Amazon SP-API Developer MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with Amazon's Selling Partner API (SP-API), specifically focused on Orders API operations and migration assistance.

Features

Migration Assistant

• migration_assistant - Assists with API version migrations
  • Provides general migration guidance (without source code)
  • Analyzes existing code and generates refactored implementations
  • Supports: Orders API v0 → v2026-01-01

Orders API Tools

V1 API (2026-01-01)

• search_orders - Search orders with various filters (date, status, marketplace, etc.)
• get_order - Get detailed information for a specific order
• cancel_order - Cancel an order with a reason code

V0 API (Legacy)

• update_shipment_status - Update shipment status for an order
• update_verification_status - Update verification status for regulated orders
• confirm_shipment - Confirm shipment for an order
• get_order_regulated_info - Get regulated information for compliance-related orders

Usage with MCP Clients

The @spectrumtest/dev-mcp package consolidates multiple SP-API MCP servers into a single npm package:

| Server | npx command arg | |--------|----------------| | SP-API Dev MCP | selling-partner-api-dev-mcp | | Amazon Data Kiosk (Seller Central) | amazon-data-kiosk-sc-mcp-server | | Amazon Data Kiosk (Vendor Central) | amazon-data-kiosk-vc-mcp-server | | SP-API MCP Server | sp-api-mcp-server |

Claude Desktop

{
  "mcpServers": {
    "sp-api-dev": {
      "command": "npx",
      "args": ["-y", "@spectrumtest/dev-mcp", "selling-partner-api-dev-mcp"],
      "env": {
        "SP_API_CLIENT_ID": "your_client_id",
        "SP_API_CLIENT_SECRET": "your_client_secret",
        "SP_API_REFRESH_TOKEN": "your_refresh_token",
        "SP_API_BASE_URL": "https://sellingpartnerapi-na.amazon.com"
      }
    },
    "amazon-data-kiosk-sc": {
      "command": "npx",
      "args": ["-y", "@spectrumtest/dev-mcp", "amazon-data-kiosk-sc-mcp-server"],
      "env": {
        "SP_API_CLIENT_ID": "your_client_id",
        "SP_API_CLIENT_SECRET": "your_client_secret",
        "SP_API_REFRESH_TOKEN": "your_refresh_token",
        "SP_API_BASE_URL": "https://sellingpartnerapi-na.amazon.com"
      }
    },
    "amazon-data-kiosk-vc": {
      "command": "npx",
      "args": ["-y", "@spectrumtest/dev-mcp", "amazon-data-kiosk-vc-mcp-server"],
      "env": {
        "SP_API_CLIENT_ID": "your_client_id",
        "SP_API_CLIENT_SECRET": "your_client_secret",
        "SP_API_REFRESH_TOKEN": "your_refresh_token",
        "SP_API_BASE_URL": "https://sellingpartnerapi-na.amazon.com"
      }
    },
    "sp-api-mcp-server": {
      "command": "npx",
      "args": ["-y", "@spectrumtest/dev-mcp", "sp-api-mcp-server"],
      "env": {
        "SP_API_CLIENT_ID": "your_client_id",
        "SP_API_CLIENT_SECRET": "your_client_secret",
        "SP_API_REFRESH_TOKEN": "your_refresh_token",
        "SP_API_BASE_URL": "https://sellingpartnerapi-na.amazon.com"
      }
    }
  }
}

Note: The env variables are optional. The migration assistant tool does not require credentials and can be used without API access.

Usage Examples

Migration Assistant - General Guidance

Prompt:

Guide me through the processes to migrate from orders V0 to V1.

Tool args:

{
  "source_version": "orders-v0",
  "target_version": "orders-2026-01-01"
}

Migration Assistant - Code Analysis

Prompt:

Help me refactor my orders V0 code
<Code snippet>

Tool args:

{
  "source_code": "your existing code here",
  "source_version": "orders-v0",
  "target_version": "orders-2026-01-01",
  "language": "javascript"
}