Skip to main content
Glama
Amazon Seller MCP

Amazon Seller MCP

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_recientes

Pedidos de las últimas N horas

resumen_ventas

Ventas agregadas (importe, pedidos, unidades)

inventario

Niveles de stock FBA por SKU

eventos_financieros

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)

  1. Seller Central → Settings → User Permissions → Develop apps for your account.

  2. Crea una aplicación y solicita los roles: Orders, Inventory, Finance y Selling Partner Insights / Sales.

  3. Tras la aprobación obtendrás LWA client_id y LWA client_secret.

  4. 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 stdio

Para 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_token da acceso continuo a tu cuenta; trátalo como una contraseña.

  • inventario puede devolver 403 si la cuenta no tiene habilitada la API de inventario FBA; el resto de herramientas funcionan con credenciales LWA.

Available Tools

4 tools
eventos_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

    A3.8/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness3/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Connects 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.
      -
    • F
      license
      Not graded
      quality
      Not graded
      maintenance
      Exposes Amazon Selling Partner API tools for sellers to manage orders, inventory, listings, pricing, analytics, and reports via natural language.
      1
      -