Amazon PA-API

Provides an MCP bridge to Amazon PA-API for product searches and related actions.

python

GitHub Stars

python

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jademind-mcp-amazon-paapi": {
      "command": "uvx",
      "args": [
        "mcp-amazon-paapi"
      ],
      "env": {
        "PAAPI_HOST": "webservices.amazon.de",
        "PAAPI_REGION": "eu-west-1",
        "PAAPI_ACCESS_KEY": "your-access-key",
        "PAAPI_SECRET_KEY": "your-secret-key",
        "PAAPI_MARKETPLACE": "www.amazon.de",
        "PAAPI_PARTNER_TAG": "your-partner-tag"
      }
    }
  }
}

You are deploying a Model Context Protocol (MCP) service that integrates the Amazon Product Advertising API. It lets your MCP clients perform product searches and related actions against PA-API from a defined, isolated server, with environment-based credentials and region settings for different marketplaces.

How to use

To operate, run the MCP server and connect your MCP client to it. The server exposes a single stdio MCP endpoint that you start via a lightweight command. You provide your PA-API credentials and regional settings through environment variables. Your client can then request product searches or related actions through the MCP interface, relying on the Amazon PA-API Python SDK underneath.

How to install

Prerequisites you need before starting: Python-based environment with uvx for MCP orchestration.

uv sync

# Activate virtual environment (choose one)
source .venv/bin/activate  # Linux/Mac
.venv\Scripts\activate     # Windows

Configuration and usage notes

Configure the MCP server to connect to PA-API by setting the required environment variables. These values give the server access to PA-API in your chosen region and marketplace.

{
  "mcpServers": {
    "amazon_paapi": {
      "command": "uvx",
      "args": [
        "mcp-amazon-paapi"
      ],
      "env": {
        "PAAPI_ACCESS_KEY": "your-access-key",
        "PAAPI_SECRET_KEY": "your-secret-key",
        "PAAPI_PARTNER_TAG": "your-partner-tag",
        "PAAPI_HOST": "webservices.amazon.de",
        "PAAPI_REGION": "eu-west-1",
        "PAAPI_MARKETPLACE": "www.amazon.de"
      }
    }
  }
}

Available tools

search_items

Search for items in a given category with a keyword, returning a list of results with details suitable for display in a client.

service_init

Initialize the Amazon PA-API service with dependency injection for testing and runtime flexibility.

server_run

Run the MCP server using the FastMCP server implementation to handle incoming MCP requests.

Built by

VeilStrat

AI signals for GTM teams