Skip to main content
AM

Amazon

v0.2.0-alpha.2API 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

What your agent can do

Amazon gives your agent 24 tools it calls directly — pick the ones it needs, in Claude, Cursor, or any MCP client.

  • list_ordersList 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.
  • get_orderGet one order by AmazonOrderId (e.g. '902-3159896-1390916').
  • get_order_itemsGet the line items for an order by AmazonOrderId. Returns ASIN, SellerSKU, quantity, item price, taxes, promotions.
Example call
// Your agent calls a tool directly — no glue code.
// CodeSpar's managed tier handles OAuth2, token rotation and rate limits.
const result = await session.call("list_orders", { /* ... */ });

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

Login with Amazon (LWA) client_id from Seller Central > Developer Central (SP-API app).

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

Run `npx -y @codespar/mcp-amazon` and add the config block above to your MCP client — Claude, Cursor, VS Code, or any MCP-compatible client. No build step, no SDK required. Prefer hosted? CodeSpar's managed tier runs it for you with auth handled.
Amazon — MCP server · 24 tools | CodeSpar