Skip to main content
A

Amazon

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

🌐 GlobalE-commerceAuth · API Keybeta24 ferramentas6 variáveis de ambienteversão prévia

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.

Comece · grátisVer docs

MIT · roda localmente com as suas credenciais

Variáveis de ambiente, nomes e descrições das ferramentas vêm do pacote npm e ficam em inglês.

Limitações

  • A v0.2.0-alpha.3 é uma versão prévia; o npm não tem versão estável deste pacote.
Pacote
@codespar/mcp-amazon
Versão
0.2.0-alpha.3 · versão prévia
dist-tag npm
latest
Categoria
E-commerce
Auth
API Key
País
🌐 Global
Licença
MIT
Transporte
stdio · streamable-http

Início rápido

Instale, configure as credenciais, faça a primeira chamada.

Escolha seu cliente. O servidor roda localmente via stdio, com as suas credenciais.

Adicione o servidor ao seu clienteUma entrada de configuração. Sem build, sem SDK.
Defina as variáveis de ambiente6 variáveis lidas pelo código deste servidor, listadas abaixo.
Reinicie e faça a primeira chamadaO agente pode chamar qualquer uma das 24 ferramentas. Comece por list_orders.
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
Variáveis de ambiente6 variáveis
AMAZON_LWA_CLIENT_IDLogin with Amazon (LWA) client_id from Seller Central > Developer Central (SP-API app).obrigatória
AMAZON_LWA_CLIENT_SECRETLWA client_secret paired with AMAZON_LWA_CLIENT_ID.obrigatóriasegredo
AMAZON_MARKETPLACE_IDDefault marketplace id. BR: A2Q3Y263D00KWC, US: ATVPDKIKX0DER, MX: A1AM78C64UM0Y8, CA: A2EUQ1WTGCTBG2. Required by most endpoints; can be overridden per-call.obrigatória
AMAZON_REFRESH_TOKENLong-lived seller-authorized refresh_token exchanged for 1-hour LWA access tokens used as x-amz-access-token.obrigatóriasegredo
AMAZON_REGIONSP-API region: 'na' (default — Americas, incl. BR/US/MX/CA), 'eu' (Europe + India + MENA), 'fe' (Far East — JP/AU/SG).opcional
AMAZON_SELLER_IDDefault sellerId (merchant token) used by Listings endpoints. Can be overridden per-call.opcional

Nomes lidos do código do pacote (@codespar/mcp-amazon@0.2.0-alpha.3). Descrições e marcações vêm do manifesto dele. Auto-hospedado, você guarda as credenciais.

Primeira chamada 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_ordersresultado devolvido

Ferramentas

O que o seu agente pode chamar.

24 ferramentas, como o tools/list do pacote as devolve.

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

Nomes e descrições vêm do tools/list do pacote (@codespar/mcp-amazon@0.2.0-alpha.3). Um tipo (leitura, escrita, exclusão) só aparece quando o pacote anota suas ferramentas ou cada ferramenta foi verificada uma a uma; nenhum dos dois existe ainda para este servidor.

Compatibilidade

MCP é um protocolo. Qualquer cliente que o fale pode montar este servidor.

O runtime da CodeSpar não roteia este servidor. Monte-o no seu cliente via stdio · streamable-http.

Protocolo

Qualquer cliente MCP

stdio · streamable-http

Perguntas

Antes de instalar.

Como instalo o servidor MCP Amazon?

Rode npx -y @codespar/mcp-amazon@0.2.0-alpha.3 e adicione o bloco de configuração acima ao seu cliente MCP: Claude Code, Cursor, Claude Desktop, VS Code ou qualquer cliente compatível. Sem build, sem SDK.

O que meu agente pode fazer com Amazon?

Amazon expõe 24 ferramentas de e-commerce. Seu agente as chama diretamente; a lista completa está acima.

Como Amazon autentica, e como as credenciais são guardadas?

Amazon usa API Key. Auto-hospedado, você guarda as credenciais: o servidor as lê das variáveis de ambiente.

Como Amazon lida com mudanças na API do provedor?

Cada servidor tem versão própria no npm. O comando desta página fixa a 0.2.0-alpha.3, a versão cujas ferramentas estão listadas aqui; seu agente segue nela até você trocar a versão.

Amazon é open source? Como reporto um bug?

Sim. Amazon tem licença MIT e está publicado no npm como @codespar/mcp-amazon, com o código no GitHub (link no painel Detalhes). Reporte problemas no repositório do pacote; problemas de segurança vão para security@codespar.dev, e respondemos em até 24 horas.

Comece em segundos.

Adicione a configuração acima, defina as variáveis, e seu agente chama as ferramentas.

Comece em segundos demo
Adicione o servidor ao seu cliente com a configuração acima.
Defina as variáveis de ambiente listadas acima.
Peça ao seu agente a primeira chamada.
Amazon — MCP server · 24 tools | CodeSpar