Amazon Product Advertising
About
A lightweight Python MCP server that exposes Amazon Product Advertising API 5.0 keyword search and ASIN lookup—returning products with your Associate partner-tagged URLs.
Details
- Author
- jademind
- Downloads
- 412
- Categories
- Cloud Service, Other, API, Search
Jump to
- Search for Amazon items by keyword and category
- Configurable host, region, and marketplace locale
- Dependency‑injected service layer for testability
- Bundled vendored PAAPI 5.0 Python SDK
- Test suite with mocking for service and error handling
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Amazon Product AdvertisingCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the server via uvx mcp-amazon-paapi and configure it in your MCP client’s JSON settings with the required environment variables (PAAPI_ACCESS_KEY, PAAPI_SECRET_KEY, PAAPI_PARTNER_TAG) and optional locale settings (PAAPI_HOST, PAAPI_REGION, PAAPI_MARKETPLACE). Locally, run uv sync to set up dependencies, then start the server with uv run python server.py.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"amazon product advertising": {
"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"
}
}
}
}
}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"
}
}
}Integrates with the Amazon Product Advertising API to search for products.
A Model Context Protocol (MCP) service for Amazon Product Advertising API integration. This project uses the Python SDK officially provided atProduct Advertising API 5.0.
For configuring host, region and markeplace, consult theLocale Reference for Product Advertising APIdocumentation.
{ "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", // select EU or US servers and region "PAAPI_REGION": "eu-west-1", "PAAPI_MARKETPLACE": "www.amazon.de" // set your preferred marketplace } } } }
mcp-amazon-paapi/ ├── src/ │ └── mcp_amazon_paapi/ # Main package │ ├── __init__.py # Package initialization │ ├── service.py # Amazon PA-API service class with dependency injection │ ├── server.py # FastMCP server implementation │ └── _vendor/ # Vendored dependencies │ └── paapi5_python_sdk/ # Amazon PA-API Python SDK ├── test/ # Test suite │ ├── __init__.py # Test package initialization │ └── test_service.py # Tests for service module ├── pyproject.toml # Project configuration and dependencies ├── uv.lock # Dependency lock file ├── README.md # Project documentation
# Sync dependencies from uv.lock (creates virtual environment automatically) uv sync # Alternatively, activate the virtual environment manually source .venv/bin/activate # Linux/Mac # or .venv\Scripts\activate # Windows
export PAAPI_ACCESS_KEY="your-access-key" export PAAPI_SECRET_KEY="your-secret-key" export PAAPI_PARTNER_TAG="your-partner-tag" export PAAPI_HOST="webservices.amazon.de" # optional defaults to webservices.amazon.de export PAAPI_REGION="eu-west-1" # optional defaults to eu-west-1 export PAAPI_MARKETPLACE="www.amazon.de" # optional, defaults to www.amazon.de
# Run all tests with uv (recommended) uv run python -m pytest test/test_service.py -v # Or if you have activated the virtual environment pytest test/test_service.py -v
- Service initialization tests
- Configuration management tests
- Search functionality tests with mocking
- Error handling tests
from service import AmazonPAAPIService # Create service (uses environment variables) service = AmazonPAAPIService() # Search for items items = service.search_items("echo dot", "Electronics", 5)
# Run directly with uv (recommended) uv run python server.py # Or if you have activated the virtual environment python server.py
Rakuten API integration for product search, hotel and travel booking, and recipe lookup across Japan's largest e-commerce platform.
Integrate with the Amazon Product Advertising API to search for products and access product information.
Search for electronic components and products using the DigiKey Product Search API.
One MCP server for 160+ live web-data APIs (search, social, e-commerce, real estate, jobs, finance) — clean JSON, free tier.
Real-time search API for AI agents. Search Google, Amazon, Walmart, and YouTube with 9 tools -- product search, product details, video search, transcripts, and more. Build price comparison agents, retail arbitrage tools, content research pipelines, and brand monitors. 500 free credits/month.
Search product catalogs across thousands of Central European e-shops. Semantic search, keyword matching, GTIN/EAN lookup — via REST API or MCP. ~2,500 e-shops | ~8.5M products | 7 countries (CZ, SK, PL, HU, RO, DE, AT)
The PayPal Model Context Protocol server allows you to integrate with PayPal APIs through function calling. This protocol supports various tools to interact with different PayPal services.
Access eBay Analytics data via the CData JDBC Driver.
An MCP server and toolkit for integrating with the commercetools platform APIs.
An MCP server that bridges the DoorDash Drive API with MCP-compatible clients.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
