Mcp Amazon

io.github.codesparPublished by GitHub account codesparv0.2.0-alpha.3Updated Oct 27, 2026

MCP server for Amazon Selling Partner API (SP-API) — orders, listings, catalog, inventory, finances

VerifiedSTDIODesktop onlyData & AnalyticsBusiness & Commerce

Overview

AI-generated overview

Local MCP server for the Amazon Selling Partner API, letting an assistant read and manage orders, listings, catalog, FBA inventory, reports and finances.

What you can do
  • List and inspect orders, order items and shipment status, and confirm or update shipments
  • Read, create, replace, patch and delete listings by SKU, and search catalog items by ASIN or keyword
  • Check FBA inventory summaries and estimate referral and FBA fees for an ASIN
  • Request, list, cancel and check reports, and submit or check feeds
  • List financial events overall or per order for reconciliation
  • Create and list Notifications API subscriptions and list the marketplaces the seller is registered in
When to use it
Useful for Amazon sellers who want an assistant to answer questions about orders, inventory, listings and fees, or to draft listing and shipment changes across NA, EU or FE marketplaces, including Brazil, Mexico and the US.
Requirements
Runs locally via npx from the npm package (Node.js). Needs a Login with Amazon app from Seller Central: AMAZON_LWA_CLIENT_ID, AMAZON_LWA_CLIENT_SECRET and a seller-authorized AMAZON_REFRESH_TOKEN, plus AMAZON_MARKETPLACE_ID; AMAZON_REGION and AMAZON_SELLER_ID are optional. Network access to Amazon's LWA token endpoint and the regional SP-API hosts is required.
Before you install
Requires long-lived seller credentials: AMAZON_LWA_CLIENT_SECRET and AMAZON_REFRESH_TOKEN grant access to the seller account and should be stored carefully. Several tools write to the live account, including put_listings_item, patch_listings_item, delete_listings_item, confirm_shipment, update_shipment_status, create_feed and create_subscription. The package is an alpha release whose tool contracts are not yet integration-tested against real seller tokens.

Installation

In SourceWeft

  1. Open Mcp Amazon in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-amazon

MCP server for the Amazon Selling Partner API (SP-API) — the biggest global marketplace, including Amazon BR, Amazon MX, Amazon US, and all EU/FE marketplaces.

For LatAm sellers, Amazon rounds out the marketplace trio already in this catalog:

  • Mercado Libre (@codespar/mcp-mercadolibre) — dominant in LatAm generally (BR, AR, MX, CO, CL).
  • Shopee (@codespar/mcp-shopee) — heavy in Brazil and rapidly growing regionally.
  • Amazon (this package) — global reach, plus Amazon BR/MX for LatAm sellers and cross-border into Amazon US/EU/JP.

Together these three cover essentially every marketplace where a LatAm merchant transacts meaningful GMV.

Tools (24)

ToolPurpose
list_ordersList orders from Amazon SP-API.
get_orderGet one order by AmazonOrderId (e.g.
get_order_itemsGet the line items for an order by AmazonOrderId.
get_listings_itemGet a single listing item for the seller by SKU.
put_listings_itemCreate or fully replace a listing item for the seller by SKU.
delete_listings_itemDelete a listing item for the seller by SKU.
search_catalog_itemsSearch the Amazon catalog for reference product data (ASIN, title, brand, images) by identifiers or keywords.
get_inventory_summaryGet FBA inventory summaries (fulfillable, inbound, reserved, researching, unfulfillable quantities) for the...
create_reportRequest an SP-API report.
get_reportGet a report's status and (when DONE) its reportDocumentId, which can then be fetched from the Reports docu...
list_financial_eventsList financial events (shipment, refund, service fee, adjustment, etc.) for reconciliation.
get_order_shipment_statusGet shipment status for a shipment id via the Shipping API (Amazon Shipping / Buy Shipping labels).
create_subscriptionCreate a Notifications API subscription for a given notificationType (webhook-equivalent for SP-API events,...
patch_listings_itemPartially update a listing item for the seller by SKU using a JSON Patch list of operations.
confirm_shipmentConfirm shipment of an order's items (Orders API v0).
update_shipment_statusUpdate the shipment status of an order (Orders API v0).
list_reportsList reports the seller has requested.
cancel_reportCancel a report that is IN_QUEUE and has not yet started processing.
create_feedSubmit a feed to SP-API (e.g.
get_feedGet a feed's status and (when DONE) its resultFeedDocumentId — fetch the result from the Feed Document API...
list_financial_events_by_orderList financial events scoped to a single order (shipment, refund, service fee, adjustment).
get_my_fees_estimate_for_asinEstimate referral fee + FBA fees for selling an ASIN at a given price.
list_subscriptionsGet the current subscription for a notificationType (one subscription per notificationType per app).
get_marketplace_participationsList all marketplaces the seller is registered to sell in (Sellers API).

Install

bash
npm install @codespar/mcp-amazon@alpha

Environment

bash
AMAZON_LWA_CLIENT_ID="amzn1.application-oa2-client....."AMAZON_LWA_CLIENT_SECRET="..."AMAZON_REFRESH_TOKEN="Atzr|..."          # long-lived, seller-authorizedAMAZON_MARKETPLACE_ID="A2Q3Y263D00KWC"   # BR; ATVPDKIKX0DER=US, A1AM78C64UM0Y8=MXAMAZON_REGION="na"                        # na | eu | fe (default na)AMAZON_SELLER_ID="A3..."                  # optional; default for Listings tools

Marketplace ids (common)

MarketplaceIdRegion
BrazilA2Q3Y263D00KWCna
United StatesATVPDKIKX0DERna
MexicoA1AM78C64UM0Y8na
CanadaA2EUQ1WTGCTBG2na
SpainA1RKKUPIHCS9HSeu
United KingdomA1F83G8C2ARO7Peu
GermanyA1PA6795UKMFR9eu
JapanA1VC38T7YXB528fe

Authentication

SP-API uses a dual-step Login with Amazon (LWA) flow:

  1. Exchange refresh token → access token (1-hour lifetime). The server POSTs to https://api.amazon.com/auth/o2/token with grant_type=refresh_token and your client_id / client_secret / refresh_token. The result is cached in memory until ~1 minute before expiry.
  2. Call SP-API with the regional base URL and header x-amz-access-token: <token> plus Content-Type: application/json.

AWS Signature v4 request signing was the historical requirement for SP-API. Amazon removed the SigV4 requirement in 2023 for most tenants, so this server uses LWA-only auth. If your seller is still flagged as requiring SigV4, you will need to wrap amazonRequest with a signer (@aws-sdk/signature-v4) — not included here.

Regional base URLs

  • NA (Americas, including BR/US/MX/CA): https://sellingpartnerapi-na.amazon.com
  • EU (Europe + India + MENA): https://sellingpartnerapi-eu.amazon.com
  • FE (Far East — Japan, Australia, Singapore): https://sellingpartnerapi-fe.amazon.com

Select with AMAZON_REGION. Brazil and the Americas use na.

Run

bash
# stdio (default — Claude Desktop, Cursor, etc)npx @codespar/mcp-amazon
# HTTP (server-to-server testing)MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-amazon

Notifications

create_subscription is webhook-equivalent for SP-API. Amazon does not push HTTP webhooks directly — instead, you create a destination (SQS queue or EventBridge bus) via POST /notifications/v1/destinations first, then attach subscriptions to that destination. This package covers subscription creation; destination provisioning is a one-time setup typically done via the AWS Console or a deploy script.

Status

0.1.0-alpha.1 — SP-API has 30+ product sections and this package covers the commerce-relevant subset (orders, listings, catalog, inventory, reports, finances, shipping, notifications). Endpoint paths and auth flow are implemented to the published spec; tool contracts should be integration-tested against real seller tokens before production use. The LWA refresh flow and x-amz-access-token header usage are confirmed against current SP-API docs.

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Source: packages/ecommerce/amazon/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.0-alpha.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts