Amazon

v0.2.0-alpha.1API Keyalpha

Amazon Selling Partner API (SP-API). Biggest global marketplace platform — covers US/EU/global + Amazon BR for cross-border LatAm sellers. Orders, listings, catalog, inventory, reports, finances, shipping, notifications. Alpha on npm — LWA auth verified; integration tests pending.

24 tools6 env vars🌐 GLOBALalpha — pending validation

Install

terminal

$ npm install @codespar/mcp-amazon@alpha

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

{
  "mcpServers": {
    "amazon": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-amazon@alpha"
      ],
      "env": {
        "AMAZON_LWA_CLIENT_ID": "<your_amazon_lwa_client_id>",
        "AMAZON_LWA_CLIENT_SECRET": "<your_amazon_lwa_client_secret>",
        "AMAZON_REFRESH_TOKEN": "<your_amazon_refresh_token>",
        "AMAZON_MARKETPLACE_ID": "<your_amazon_marketplace_id>"
      }
    }
  }
}

After restart, your agent can call any of the 24 tools below — try list_orders first.

Environment variables · 6

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

AMAZON_LWA_CLIENT_ID

required

AMAZON_LWA_CLIENT_SECRET

requiredsecret

LWA client_secret paired with AMAZON_LWA_CLIENT_ID.

AMAZON_REFRESH_TOKEN

requiredsecret

Long-lived seller-authorized refresh_token exchanged for 1-hour LWA access tokens used as x-amz-access-token.

AMAZON_MARKETPLACE_ID

required

Default marketplace id. BR: A2Q3Y263D00KWC, US: ATVPDKIKX0DER, MX: A1AM78C64UM0Y8, CA: A2EUQ1WTGCTBG2. Required by most endpoints; can be overridden per-call.

AMAZON_REGION

optional

SP-API region: 'na' (default — Americas, incl. BR/US/MX/CA), 'eu' (Europe + India + MENA), 'fe' (Far East — JP/AU/SG).

AMAZON_SELLER_ID

optional

Default sellerId (merchant token) used by Listings endpoints. Can be overridden per-call.

Available tools · 24

Each tool is independent — your agent loads only what it needs to reduce context and response time.

READlist_orders

List orders from Amazon SP-API. Filters by marketplace, creation/update time, order status, fulfillment channel, etc. Returns a page of orders plus NextToken for pagination.

READget_order

Get one order by AmazonOrderId (e.g. '902-3159896-1390916').

READget_order_items

Get the line items for an order by AmazonOrderId. Returns ASIN, SellerSKU, quantity, item price, taxes, promotions.

READget_listings_item

Get a single listing item for the seller by SKU.

WRITEput_listings_item

Create or fully replace a listing item for the seller by SKU. Body must be a Listings Items submission (productType + attributes).

DELETEdelete_listings_item

Delete a listing item for the seller by SKU.

READsearch_catalog_items

Search the Amazon catalog for reference product data (ASIN, title, brand, images) by identifiers or keywords. Use this to map merchant SKUs to ASINs before creating listings.

READget_inventory_summary

Get FBA inventory summaries (fulfillable, inbound, reserved, researching, unfulfillable quantities) for the seller's SKUs.

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.