Amazon Seller MCP Server

MCP (Model Context Protocol) server exposing Amazon Selling Partner API tools for sellers. Built from the Swagger models in ../models/.

Tools (47)

Full coverage of every operation in the underlying API models per group.

Group	Tools
Orders (Orders API v0 — all 10 ops)	search_orders, get_order (header+items), get_order_items, get_order_buyer_info †, get_order_address †, get_order_items_buyer_info †, confirm_shipment, update_shipment_status (in-store pickup), get_order_regulated_info, update_verification_status
FBA / Inventory (FBA Inventory + Inbound Eligibility)	get_fba_inventory (low-stock flagging), check_fba_inbound_eligibility, create_sandbox_inventory_item ‡, delete_sandbox_inventory_item ‡, add_sandbox_inventory ‡
Listings (Listings Items 2021-08-01 — all 5 ops + Restrictions + Product Type Definitions)	search_listings, get_listing, update_listing (PATCH price/qty, validation preview), create_or_replace_listing (PUT), delete_listing, get_listing_restrictions (gating check), search_product_types, get_product_type_definition
Catalog (Catalog Items 2022-04-01)	search_catalog, get_catalog_item
Pricing (Product Pricing v0 — all 6 ops + 2022-05-01 + Product Fees — all 3 ops)	get_pricing, get_competitive_pricing, get_item_offers, get_listing_offers, get_item_offers_batch, get_listing_offers_batch, get_featured_offer_expected_price (buy box target price), get_competitive_summary, estimate_fees, estimate_fees_batch
Analytics (Sales + Finances v0 — all 4 ops)	get_sales_metrics, list_financial_events (date range or per order), list_financial_event_groups (settlements), list_financial_events_by_group
Reports (Reports 2021-06-30 — all 9 ops)	create_report, get_report (auto-download + gunzip), list_reports, cancel_report, create_report_schedule, list_report_schedules, get_report_schedule, cancel_report_schedule

† Buyer PII — requires the restricted (PII) role on your SP-API app; the server creates the Restricted Data Token automatically via the Tokens API. ‡ Sandbox only — requires SPAPI_SANDBOX=true; used to seed FBA sandbox test data.

Setup

cd mcp-server
npm install
npm run build

Credentials

Self-authorize an SP-API app in Seller Central (Apps & Services → Develop Apps) to obtain LWA credentials and a refresh token. SP-API no longer requires AWS SigV4 — only the LWA token.

Variable	Required	Description
SPAPI_LWA_CLIENT_ID	yes	LWA client ID of your SP-API app
SPAPI_LWA_CLIENT_SECRET	yes	LWA client secret
SPAPI_REFRESH_TOKEN	yes	Refresh token from the seller authorization
SPAPI_REGION	no	na (default), eu, or fe
SPAPI_DEFAULT_MARKETPLACE	no	Country code, default US
SPAPI_SELLER_ID	for listings	Merchant token (Settings → Account Info → Merchant Token)
SPAPI_SANDBOX	no	true to use the SP-API sandbox

Claude Desktop / Claude Code config

{
  "mcpServers": {
    "amazon-seller": {
      "command": "node",
      "args": ["/path/to/selling-partner-api-models/mcp-server/dist/index.js"],
      "env": {
        "SPAPI_LWA_CLIENT_ID": "amzn1.application-oa2-client...",
        "SPAPI_LWA_CLIENT_SECRET": "...",
        "SPAPI_REFRESH_TOKEN": "Atzr|...",
        "SPAPI_REGION": "na",
        "SPAPI_DEFAULT_MARKETPLACE": "US",
        "SPAPI_SELLER_ID": "A1EXAMPLE"
      }
    }
  }
}

Or with Claude Code: claude mcp add amazon-seller -e SPAPI_LWA_CLIENT_ID=... -e SPAPI_LWA_CLIENT_SECRET=... -e SPAPI_REFRESH_TOKEN=... -- node /path/to/mcp-server/dist/index.js

Notes

• Buyer PII tools (get_order_buyer_info, get_order_address, get_order_items_buyer_info) create a Restricted Data Token automatically (cached ~1h). A 403 means your SP-API app lacks the restricted role approval from Amazon.
• Responses are truncated at 25,000 characters with pagination hints; all tools support nextToken/pageToken where the API does.
• 429 throttling is retried automatically with exponential backoff (up to 3 retries).
• update_listing supports validateOnly: true (VALIDATION_PREVIEW) to dry-run a patch before applying.