Amazon

@codespar/mcp-amazon · v0.2.0-alpha.3

🌐 GlobalE-CommerceAuth · API Keybeta24 tools6 env varsprerelease

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.

Get started · free View docs

MIT · runs locally with your own credentials

Limitations

v0.2.0-alpha.3 is a prerelease; npm has no stable release of this package.

DetailsSource on GitHub

Package: @codespar/mcp-amazon
Version: 0.2.0-alpha.3 · prerelease
npm dist-tag: latest
Category: E-Commerce
Auth: API Key
Country: 🌐 Global
License: MIT
Transport: stdio · streamable-http

npm GitHub Server catalog docs

Quickstart

Install, set the credentials, make the first call.

Pick your client. The server runs locally over stdio, with your own credentials.

Add the server to your clientOne config entry. No build step, no SDK required.

Set the environment variables6 variables read by this server's code, listed below.

Restart and make the first callThe agent can call any of the 24 tools. Try list_orders first.

Hosted MCP Build your own server

terminal

# Claude Code
claude mcp add amazon -e AMAZON_LWA_CLIENT_ID=… -e AMAZON_LWA_CLIENT_SECRET=… -e AMAZON_MARKETPLACE_ID=… -e AMAZON_REFRESH_TOKEN=… -e AMAZON_REGION=… -e AMAZON_SELLER_ID=… -- npx -y @codespar/mcp-amazon@0.2.0-alpha.3
# then: /mcp to confirm the server is connected

Environment variables6 variables

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

AMAZON_LWA_CLIENT_SECRETLWA client_secret paired with AMAZON_LWA_CLIENT_ID.requiredsecret

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

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

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

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

Names read from the package code (@codespar/mcp-amazon@0.2.0-alpha.3). Descriptions and flags come from its manifest. Self-hosted, you hold the credentials.

First call demolist_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"

tools/calllist_ordersresult returned

Tools

What your agent can call.

24 tools, as the package's tools/list returns them.

list_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.

get_order

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

get_order_items

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

get_listings_item

Get a single listing item for the seller by SKU.

put_listings_item

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

delete_listings_item

Delete a listing item for the seller by SKU.

search_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.

get_inventory_summary

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

create_report

Request an SP-API report. Report is generated asynchronously — poll with get_report until processingStatus is DONE, then fetch the reportDocumentId.

get_report

Get a report's status and (when DONE) its reportDocumentId, which can then be fetched from the Reports document API.

list_financial_events

List financial events (shipment, refund, service fee, adjustment, etc.) for reconciliation. Filter by posted-time window or by AmazonOrderId.

get_order_shipment_status

Get shipment status for a shipment id via the Shipping API (Amazon Shipping / Buy Shipping labels).

Names and descriptions come from the package's tools/list (@codespar/mcp-amazon@0.2.0-alpha.3). A kind (read, write, delete) is shown only when the package annotates its tools or each tool was verified one by one; neither exists for this server yet.

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

The CodeSpar runtime does not route this server. Mount it in your client over stdio · streamable-http.

Protocol

Any MCP client

stdio · streamable-http

Questions

Before you install.

How do I install the Amazon MCP server?

Run npx -y @codespar/mcp-amazon@0.2.0-alpha.3 and add the config block above to your MCP client: Claude Code, Cursor, Claude Desktop, VS Code, or any MCP-compatible client. No build step, no SDK required.

What can my agent do with Amazon?

Amazon exposes 24 tools for e-commerce. Your agent calls them directly; the full list is above.

How does Amazon authenticate, and how are credentials stored?

Amazon uses API Key. Self-hosted, you hold the credentials: the server reads them from its environment variables.

How does Amazon handle upstream API changes?

Every server is versioned independently on npm. The command on this page pins 0.2.0-alpha.3, the version whose tools are listed here; your agent keeps running it until you change the version.

Is Amazon open source? How do I report a bug?

Yes. Amazon is MIT-licensed and published on npm as @codespar/mcp-amazon, source on GitHub (link in the Details panel). Report issues on the package repository; security issues go to security@codespar.dev, and we respond within 24 hours.

Pairs well with