Amazon Selling Partner API (SP-API). A maior plataforma de marketplace global — cobre US/EU/global + Amazon BR pra sellers cross-border da LatAm. Pedidos, listings, catálogo, estoque, relatórios, finanças, envio, notificações. Alpha no npm — auth LWA verificada; testes de integração pendentes.
O Amazon dá ao seu agente 24 tools que ele chama direto — escolha as que precisar, no Claude, Cursor ou qualquer cliente MCP.
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.// 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", { /* ... */ });$ npm install @codespar/mcp-amazon@alphaAdicione esta entrada ao seu claude_desktop_config.json (ou a config de qualquer cliente compatível com MCP).
{
"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>"
}
}
}
}Depois de reiniciar, seu agente pode chamar qualquer uma das 24 ferramentas abaixo — teste list_orders primeiro.
Necessárias pra autenticar o server. Armazenadas criptografadas ao usar a hospedagem gerenciada da CodeSpar.
AMAZON_LWA_CLIENT_IDLogin with Amazon (LWA) client_id from Seller Central > Developer Central (SP-API app).
AMAZON_LWA_CLIENT_SECRETLWA client_secret paired with AMAZON_LWA_CLIENT_ID.
AMAZON_REFRESH_TOKENLong-lived seller-authorized refresh_token exchanged for 1-hour LWA access tokens used as x-amz-access-token.
AMAZON_MARKETPLACE_IDDefault marketplace id. BR: A2Q3Y263D00KWC, US: ATVPDKIKX0DER, MX: A1AM78C64UM0Y8, CA: A2EUQ1WTGCTBG2. Required by most endpoints; can be overridden per-call.
AMAZON_REGIONSP-API region: 'na' (default — Americas, incl. BR/US/MX/CA), 'eu' (Europe + India + MENA), 'fe' (Far East — JP/AU/SG).
AMAZON_SELLER_IDDefault sellerId (merchant token) used by Listings endpoints. Can be overridden per-call.
Cada ferramenta é independente — seu agente carrega só o que precisa pra reduzir contexto e tempo de resposta.
list_ordersget_orderget_order_itemsget_listings_itemput_listings_itemdelete_listings_itemsearch_catalog_itemsget_inventory_summaryMCP é um protocolo — qualquer framework que o fale pode montar este server.