Amazon PA-API MCP Service

Overview

Amazon PA-API MCP Service is a stdio MCP server for Amazon Product Advertising API 5.0. It exposes Amazon Associates product search and item lookup through the published PyPI package mcp-amazon-paapi.

The requested repository is jademind/mcp-amazon-api; the source package metadata and PyPI project URLs use the package name mcp-amazon-paapi.

Installation

The README documents MCP client configuration with:

uvx mcp-amazon-paapi

For local development, the README documents uv sync, optional virtual environment activation, uv run python -m pytest test/test_service.py -v, and direct local execution with uv run python server.py or python server.py.

Configuration

Required environment variables:

• PAAPI_ACCESS_KEY: Amazon Product Advertising API access key.
• PAAPI_SECRET_KEY: Amazon Product Advertising API secret key.
• PAAPI_PARTNER_TAG: Amazon Associates partner tag used in Product Advertising API requests and returned product URLs.

Optional locale variables:

• PAAPI_HOST: defaults to webservices.amazon.de.
• PAAPI_REGION: defaults to eu-west-1.
• PAAPI_MARKETPLACE: defaults to www.amazon.de.

The README links Amazon's Product Advertising API locale reference for selecting host, region, and marketplace values.

Capabilities

• search_items: searches the configured Amazon marketplace by keyword, optional category/search index, optional item count, and optional sort order.
• item://{asin}: MCP resource that returns a single Amazon item by ASIN.

Returned item data includes ASIN, title, detail page URL, price when available, content rating, adult-product flag, and primary image metadata when available.

Limitations

• Requires valid Amazon Product Advertising API 5.0 credentials and an Amazon Associates partner tag.
• Product Advertising API availability, locale values, access, throttling, and results are controlled by Amazon.
• The server defaults to the German Amazon locale unless host, region, and marketplace are configured.
• The implementation returns an empty list or None when the Amazon API returns errors or no results.
• The source exposes search and item lookup only; it does not perform purchases, cart actions, account management, or write operations.
• No remote hosted endpoint or HTTP transport is documented for this package; the reviewed package target is local stdio via uvx.