Amazon Selling Partner API (SP-API). La mayor plataforma de marketplace global — cubre US/EU/global + Amazon BR para sellers transfronterizos de LatAm. Pedidos, listings, catálogo, inventario, reportes, finanzas, envío, notificaciones. Alpha en npm — auth LWA verificada; tests de integración pendientes.
Amazon le da a tu agente 24 tools que llama directo — elegí las que necesite, en Claude, Cursor o cualquier 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@alphaAgregá esta entrada a tu claude_desktop_config.json (o a la config de cualquier cliente compatible con 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>"
}
}
}
}Después de reiniciar, tu agente puede llamar cualquiera de las 24 herramientas de abajo — probá list_orders primero.
Necesarias para autenticar el server. Almacenadas cifradas al usar el hosting gestionado de 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 herramienta es independiente — tu agente carga solo lo que necesita para reducir contexto y tiempo de respuesta.
list_ordersget_orderget_order_itemsget_listings_itemput_listings_itemdelete_listings_itemsearch_catalog_itemsget_inventory_summaryMCP es un protocolo — cualquier framework que lo hable puede montar este server.