Amazon Seller MCP
Allows querying orders, sales summaries, FBA inventory, and financial events from Amazon Seller Central via the Selling Partner API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Amazon Seller MCP List my orders from the past 12 hours"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Conector MCP — Amazon Seller Central
Servidor MCP que conecta Claude con tu cuenta de Amazon Seller Central vía la Selling Partner API (SP-API). Permite consultar pedidos, resumen de ventas, inventario FBA y eventos financieros bajo demanda.
Herramientas expuestas
Herramienta | Qué hace |
| Pedidos de las últimas N horas |
| Ventas agregadas (importe, pedidos, unidades) |
| Niveles de stock FBA por SKU |
| Liquidaciones, comisiones y fees recientes |
Related MCP server: Amazon SP-API MCP Server
Instalar en un ordenador nuevo (vía uvx)
Requisito único: tener uv instalado
(curl -LsSf https://astral.sh/uv/install.sh | sh). uv descarga Python y las
dependencias automáticamente — no hay que crear entornos ni instalar nada más.
Registra el conector en Claude (Code o Cowork) con un solo comando:
claude mcp add amazon-seller \
--env SPAPI_REFRESH_TOKEN=TU_REFRESH_TOKEN \
--env SPAPI_LWA_APP_ID=TU_APP_ID \
--env SPAPI_LWA_CLIENT_SECRET=TU_CLIENT_SECRET \
--env SPAPI_MARKETPLACE=ES \
-- uvx --from git+https://github.com/USUARIO/amazon-seller-mcp amazon-seller(Sustituye USUARIO por tu usuario de GitHub y rellena tus credenciales.)
Reinicia Claude y pregúntame, por ejemplo:
"¿Cuántas ventas llevo hoy?"
"Dame los pedidos de las últimas 6 horas"
Conseguir las credenciales (una sola vez)
Seller Central → Settings → User Permissions → Develop apps for your account.
Crea una aplicación y solicita los roles: Orders, Inventory, Finance y Selling Partner Insights / Sales.
Tras la aprobación obtendrás
LWA client_idyLWA client_secret.Autoriza la app sobre tu propia cuenta (self-authorization) para generar el refresh token.
Desde 2024 la SP-API ya no requiere claves AWS IAM ni firma SigV4: basta con las credenciales LWA.
Las mismas credenciales valen para todos tus ordenadores. Se pasan como variables de entorno en la config de Claude (ver arriba); nunca van dentro del repositorio.
Desarrollo local
uv run amazon-seller # arranca el servidor por stdioPara pruebas locales puedes poner las credenciales en un .env (gitignored);
en producción se pasan como --env en la config de Claude.
Notas
La SP-API es pull, no streaming: consulto la API en el momento que preguntas. Amazon aplica throttling, evita consultas en bucle.
El
refresh_tokenda acceso continuo a tu cuenta; trátalo como una contraseña.inventariopuede devolver 403 si la cuenta no tiene habilitada la API de inventario FBA; el resto de herramientas funcionan con credenciales LWA.
Available Tools
4 toolseventos_financierosB
Eventos financieros recientes (liquidaciones, comisiones, fees).
Args: dias: ventana hacia atrás en días (default 7). max_eventos: máximo de grupos de eventos (default 30).
Inputs: dias, max_eventos.
inventarioA
Niveles de inventario FBA por SKU en el marketplace actual.
Args: max_items: máximo de SKUs a devolver (default 50).
Inputs: max_items.
pedidos_recientesA
Lista los pedidos de las últimas N horas.
Args: horas: ventana hacia atrás en horas (default 24). max_pedidos: máximo de pedidos a devolver (default 50).
Inputs: horas, max_pedidos.
resumen_ventasA
Resumen agregado de ventas (importe, pedidos, unidades) por periodo.
Args: dias: número de días hacia atrás a incluir (default 1 = hoy). granularidad: Hour, Day, Week, Month, Year (default Day).
Inputs: dias, granularidad.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool covers a distinct domain area—financial events, inventory, orders, and sales summary—with no functional overlap. An agent can clearly distinguish which tool to use for each query type.
All tool names follow a consistent snake_case pattern using descriptive Spanish nouns or noun phrases (eventos_financieros, inventario, pedidos_recientes, resumen_ventas). The naming convention is uniform and predictable.
With 4 tools, the server is minimal but well-scoped for core Amazon seller operations (financials, inventory, orders, sales). It could benefit from additional tools (e.g., for returns or product data), but the current count is reasonable for a focused tool set.
The tool set covers essential financial, inventory, order, and sales summary functions, but lacks support for product management, advertising, or performance metrics. This leaves notable gaps for a comprehensive seller management server.
Related MCP Connectors
Connect Amazon Seller Central to Claude or ChatGPT via MCP. Orders, inventory, pricing, fees, FBA.
Amazon Seller Central, Ads and Vendor Central in ChatGPT & Claude. 106 tools; writes need approval.
Amazon Seller Central and Ads inside Claude, ChatGPT or Grok. Fees from your own settlements.
Amazon Seller Central and Ads inside Claude, ChatGPT or Grok. Fees from your own settlements.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceConnects Claude to PrintSmith Vision for read-only AI-assisted print shop management. It enables users to query customer data, production job statuses, and financial summaries through natural language.-
- AlicenseAqualityCmaintenanceConnects Claude to Amazon Seller Central via the SP-API for natural language queries on sales, inventory, reports, fees, reimbursements, and analytics.2052MIT
- AlicenseCqualityDmaintenanceConnects your Shopify store data to Claude Desktop, enabling access to products, orders, customers, inventory, and more through natural language.154MIT
- FlicenseNot gradedqualityNot gradedmaintenanceExposes Amazon Selling Partner API tools for sellers to manage orders, inventory, listings, pricing, analytics, and reports via natural language.1-