mcp-amazon

mcp-amazon is a read-only, source-scoped MCP server for Amazon wishlist data.

Version 0.1.0 supports two read paths:

• HTML snapshot parsing for stable, low-risk reads

• optional live browser-backed reads with an operator-supplied storage state

It follows the shared source conventions documented in mcp-source-playbook and mcp-source-foundation.

Implemented

• MCP stdio server via mcp-amazon-server

• profile and health reporting

• wishlist reads through amazon_wishlist_items

• focused unit tests for parsing and profile behavior

Related MCP server: Amazon Product Intelligence Agent

Tools

• amazon_profile

• amazon_health

• amazon_wishlist_items

Configuration

Use either a saved HTML snapshot or a wishlist ID:

export AMAZON_WISHLIST_HTML_PATH="/path/to/wishlist.html"
export AMAZON_WISHLIST_ID="wishlist-id"
export AMAZON_STORAGE_STATE="/path/to/storage-state.json"
export AMAZON_DOMAIN="www.amazon.co.jp"

CLI

mcp-amazon profile --format json
mcp-amazon wishlist --format json
mcp-amazon-server

Safety

• read-only by default

• write and account-changing operations are not implemented in v1

• live browser reads are opt-in and require operator-managed session state

Development

python -m pytest