Skip to main content
Glama
trinknx

Amazon Seller MCP Server

by trinknx
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
TypeScript
Remote

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.

Related MCP server: Amazon SP-API MCP Server

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.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers