Skip to main content
Glama
mattcoatsworth

Amazon Selling Partner API MCP Server

README.md
# Amazon Selling Partner API MCP Server

    A Model Context Protocol (MCP) server for interacting with the Amazon Selling Partner API. This server provides tools and resources for accessing Amazon SP-API functionality through a standardized interface.

    ## Features

    - Authentication and authorization with Amazon SP-API
    - Comprehensive coverage of SP-API endpoints
    - Documentation resources for API reference
    - Tools for managing catalog, inventory, orders, reports, and more
    - Secure credential handling

    ## Prerequisites

    - Node.js 16 or higher
    - Amazon Selling Partner API credentials
    - AWS credentials with appropriate permissions

    ## Installation

    ```bash
    npm install amazon-sp-api-mcp-server
    ```

    Or run directly with npx:

    ```bash
    npx amazon-sp-api-mcp-server
    ```

    ## Configuration

    Create a `.env` file in the root directory with your Amazon SP-API credentials:

    ```
    SP_API_CLIENT_ID=your_client_id
    SP_API_CLIENT_SECRET=your_client_secret
    SP_API_REFRESH_TOKEN=your_refresh_token
    SP_API_AWS_ACCESS_KEY=your_aws_access_key
    SP_API_AWS_SECRET_KEY=your_aws_secret_key
    SP_API_ROLE_ARN=your_role_arn
    SP_API_MARKETPLACE_ID=ATVPDKIKX0DER
    SP_API_REGION=us-east-1
    ```

    ## Usage

    Start the server:

    ```bash
    npm start
    ```

    For development with auto-restart:

    ```bash
    npm run dev
    ```

    To test with MCP Inspector:

    ```bash
    npm run inspect
    ```

    ## Available Tools

    The server provides tools for interacting with various aspects of the Amazon Selling Partner API:

    - Authentication tools
    - Catalog tools
    - Inventory management
    - Order processing
    - Report generation and retrieval
    - Feed submission
    - Financial data access
    - Notification management
    - Product pricing
    - Listings management
    - FBA operations

    ## Documentation Resources

    Access API documentation through the `amazon-sp-api://{category}` resource, where category can be:

    - overview
    - authentication
    - catalog
    - orders
    - inventory
    - reports
    - feeds
    - finance
    - notifications
    - productPricing
    - listings
    - fba

    ## License

    MIT