AMZ Vault

Amazon Seller Central + Ads: P&L preciso según liquidaciones, PPC completo, cada escritura preparada para aprobación.

Documentación

AMZ Vault MCP

Conecta Claude (o cualquier cliente de IA compatible con MCP) directamente a tus datos de Amazon Seller Central y Amazon Ads: rentabilidad real, rendimiento de PPC a cualquier nivel de detalle, inventario, pronósticos y cambios seguros con aprobación previa.

  • Endpoint: https://www.amz-vault.com/mcp (HTTP Streamable)
  • Autenticación: OAuth 2.1 con registro dinámico de clientes: inicia sesión con tu cuenta de AMZ Vault cuando tu cliente de IA lo solicite. No hay claves API que crear, copiar o filtrar.
  • Escrituras: cada cambio se COLOCA EN ESPERA. Nada llega a Amazon hasta que revises el diff y lo confirmes.

Este repositorio es el listado público del registro para el servidor MCP de AMZ Vault alojado. El servidor en sí se ejecuta en amz-vault.com; no hay código que instalar o ejecutar desde aquí.

Inicio rápido (Claude)

  1. Crea una cuenta de AMZ Vault en amz-vault.com y conecta tu cuenta de Amazon (prueba gratuita de 14 días, sin tarjeta requerida).
  2. En Claude: Configuración -> Conectores -> Agregar conector personalizado y pega https://www.amz-vault.com/mcp.
  3. Claude abre la pantalla de inicio de sesión y consentimiento de AMZ Vault. Aprueba.
  4. Pregunta lo que quieras: "¿Qué tan rentable fue mi cuenta el mes pasado, después de todas las tarifas?"

¿Quieres probar las herramientas antes de conectar tu propia cuenta? La demo en vivo se ejecuta con una cuenta de vendedor sintética y no requiere registro.

Qué lo hace diferente

  • Rentabilidad basada en liquidaciones, no en estimaciones del panel. Las herramientas de P&L concilian pedidos, reembolsos, cada clase de tarifa de Amazon, COGS y tus gastos operativos contra los datos reales de liquidación: el número con el que tu cuenta bancaria está de acuerdo.
  • Respuestas al nivel de detalle correcto. Las preguntas sobre productos obtienen respuestas a nivel de producto, las preguntas sobre campañas obtienen respuestas a nivel de campaña, y cada respuesta está etiquetada con su alcance para que el gasto de campañas compartidas nunca se cuente dos veces.
  • Escrituras en espera con aprobación humana. Cambios de oferta, negativos, presupuestos, creación de campañas, ediciones de listados: la IA propone, tú ves el diff exacto y solo tu confirmación lo ejecuta. No existe modo de escritura autónoma.
  • Toda la cuenta, no solo anuncios. PPC, rendimiento de búsqueda orgánica (SQP), Brand Analytics, inventario y reposición, MCF, contenido A+, pronósticos por ASIN y planificación de reorden en un solo conector.

Ejemplos de prompts

  • "¿Qué productos perdieron dinero el mes pasado después de todas las tarifas y el gasto en anuncios?"
  • "Encuentra términos de búsqueda que están gastando sin generar pedidos y coloca negativos en espera para mi aprobación."
  • "Compara mi rendimiento de SP vs SB vs SD este trimestre."
  • "¿Por qué palabras clave está posicionado el ASIN de mi principal competidor en las que yo no estoy pujando?"
  • "¿Cuándo necesito reordenar cada SKU, dados la velocidad actual y los tiempos de entrega?"
  • "Coloca en espera una reducción del 15% en la oferta de cada objetivo por encima del 60% de ACoS en los últimos 30 días: muéstrame la lista primero."

Configuración del cliente

ClienteCómo
Claude (web / escritorio)Configuración -> Conectores -> Agregar conector personalizado -> https://www.amz-vault.com/mcp
Claude Codeclaude mcp add --transport http amz-vault https://www.amz-vault.com/mcp
CursorConfiguración -> MCP -> Agregar servidor -> escribe streamable-http, URL https://www.amz-vault.com/mcp
VS Code (Copilot)MCP: Add Server desde la paleta de comandos -> HTTP -> https://www.amz-vault.com/mcp
WindsurfAgregar a mcp_config.json: {"mcpServers": {"amz-vault": {"serverUrl": "https://www.amz-vault.com/mcp"}}}
Cualquier otra cosaCualquier cliente que hable MCP Streamable HTTP + OAuth 2.1 funciona. Los metadatos son descubribles en /.well-known/oauth-protected-resource/mcp.

En el primer uso, cada cliente pasa por la misma pantalla de inicio de sesión y consentimiento de OAuth: aprueba una vez por cliente y estarás conectado.

Catálogo de herramientas

Generado desde el registro de herramientas en vivo el 2026-09-05. La referencia siempre actualizada, incluida la documentación completa de parámetros, está en amz-vault.com/docs.

Cuenta y descubrimiento

HerramientaQué hace
account_feedbackCanal de comentarios y soporte al equipo de AMZ Vault (NO es una escritura de Amazon): action=submit abre un hilo (asunto, cuerpo, categoría bug|idea|qu...
account_management_guideEl marco de decisión de marca y PPC del operador: columna vertebral de margen (PPD + bandas de margen), posturas de producto, estructura de campaña/ofertas, cosech...
account_profilesLista los perfiles publicitarios (cuentas de PPC) conectados a las conexiones de vendedor de este token.
account_reportLA vista general canónica de la cuenta: UNA llamada: tarjetas de período + cascada de liquidación + advertencias de frescura para los conjuntos de datos de dinero, con quote_rules
account_sellersLista las conexiones de vendedor de Amazon a las que este token puede acceder, con sus marketplaces y monedas.
account_support_accessOtorga o revoca la vista SOLO LECTURA del equipo de soporte de AMZ Vault de esta cuenta: action=grant permite que el soporte vea lo que el usuario ve durante 7 días...

Almacén de datos

HerramientaQué hace
data_describeSin argumentos: lista cada conjunto de datos del almacén disponible para data_query
data_freshnessFrescura de sincronización por conjunto de datos, recuentos de filas, cobertura de fechas y progreso de relleno: úsalo para advertir correctamente las respuestas
data_queryConsulta genérica sobre cualquier conjunto de datos del almacén (ver data_describe): proyección de columnas, filtros (eq/neq/gt/gte/lt/lte/in/contains), límites de fecha,...

P&L / rentabilidad

HerramientaQué hace
pnl_breakdownCascada de cuenta basada en liquidaciones: ingresos → reembolsos → COGS → ganancia bruta → tarifas de Amazon → margen de contribución → publicidad → ganancia neta...
pnl_by_asinFilas de P&L por ASIN para una ventana de fechas (opcionalmente un ASIN): ventas, unidades, tarifas, COGS, márgenes, TACoS, stock.
pnl_expensesGastos operativos personalizados (suscripciones, VA, flete, 3PL…): alcance, recurrencia, montos.
pnl_mcf_summaryTotales de Multi-Channel Fulfillment (fuera de Amazon): unidades, pedidos, tarifas de cumplimiento y COGS para una ventana.
pnl_period_cardsLas tarjetas mini-P&L del panel (Hoy / Ayer / MTD / Pronóstico de este mes / Mes pasado).
pnl_refundsComponentes de reembolso para una ventana: monto neto de reembolso, recuento y líneas detalladas (reembolsos, reposición de stock).
pnl_sb_attributionAtribución de costos de Sponsored Brands por ASIN (la división ponderada por ventas del gasto de SB a nivel de campaña).
pnl_settlement_auditAuditoría de tarifas de liquidación: cada combinación distinta de tarifas que Amazon cobró, clasificada en categorías de P&L: verifica que nada esté mal clasificado o mal...
pnl_summaryResumen de ganancias y pérdidas para una ventana de fechas: mosaicos de cuenta (ventas, tarifas, COGS, gasto en anuncios, ganancia bruta, margen de contribución, ganancia neta, TACoS...

Productos e inventario

HerramientaQué hace
inventory_healthUnidades FBA cumplibles/entrantes/reservadas, inventario envejecido, recomendaciones de reposición y grupo AWD por SKU
product_cogsCostos actuales por SKU en tierra (COGS) y resumen de cobertura.
product_fee_previewTarifas estimadas propias de Amazon por SKU para las próximas semanas (referido, cumplimiento, almacenamiento).
product_libraryEl catálogo de productos canónico con ACoS de punto de equilibrio y objetivos de margen BE efectivos por familia de productos.

Brand Analytics

HerramientaQué hace
brand_market_basketLo que los clientes compran junto con cada ASIN (pares comprados juntos y participaciones de combinación).
brand_repeat_purchaseLealtad del cliente por ASIN: participación de compradores recurrentes e ingresos recurrentes por semana.
brand_search_catalogTotales del embudo de búsqueda por ASIN en TODAS las consultas (SQP sin consulta): impresiones, clics, agregados al carrito, compras, precios medios.
brand_sqpRendimiento de consultas de búsqueda: embudo de búsqueda orgánica por (ASIN, consulta): impresiones/clics/agregados al carrito/compras con participaciones
brand_top_search_termsTérminos de búsqueda principales a nivel de marketplace con los 3 ASIN más clickeados y sus participaciones de clic/conversión

Inteligencia de palabras clave

HerramientaQué hace
keyword_finderBuscador de palabras clave (búsqueda inversa de ASIN / entrada múltiple): cada frase de palabra clave por la que se conocen los ASIN de entrada, combinada de datos de primera parte: SQ...

PPC — lectura

HerramientaQué hace
ppc_account_summaryObtén métricas agregadas a nivel de cuenta para un rango de fechas: gasto total, ventas, ACoS, ROAS, clics, impresiones, compras.
ppc_ad_groupsConsulta datos de rendimiento de grupos de anuncios dentro de campañas
ppc_ad_type_breakdownObtén comparación de rendimiento entre tipos de anuncios (SP vs SB vs SD)
ppc_advertised_productsConsulta rendimiento a nivel de producto/ASIN (grano de anuncio SP+SD, combinado por ASIN con división por programa; el gasto por ASIN de SB existe solo en el blen...
ppc_asset_upload_linkGenera un enlace de carga de navegador de 1 hora para que el USUARIO pueda entregar un archivo local (los adjuntos de chat no pueden llegar al servidor)
ppc_bid_recommendationsOferta sugerida de Amazon + rango por palabra clave para una campaña ESPECÍFICA (enrutada por tipo de campaña)
ppc_budget_alertsEncuentra campañas que se acercan o superan su presupuesto diario
ppc_campaign_create_guideEl contrato verificado para crear campañas mediante stage_campaign_create: campos requeridos por formato, objetivos, reglas de página de destino, fuente de activos...
ppc_campaign_detailsObtén datos detallados para campañas SP específicas, incluidas ubicaciones, ASIN anunciados, modificadores de ubicación y palabras clave/objetivos principales
ppc_campaign_metadataConfiguración de campaña y metadatos de usuario: estrategia de oferta, configuración de ubicación, objetivo/KPI, etiquetas, notas.
ppc_campaign_searchBúsqueda ligera de nombres de campaña
ppc_campaignsConsulta datos de rendimiento de campañas con filtros opcionales
ppc_change_historyObtén historial reciente de cambios de campaña que muestre qué cambió, cuándo, valores antiguos y valores nuevos
ppc_conversion_funnelObtén datos del embudo de conversión: Impresiones → Clics → Pedidos con tasas entre cada etapa
ppc_creativesCreatividades de anuncios SB a nivel de anuncio (titular, logotipo de marca, imágenes personalizadas, IDs de activos de video, ASIN, página de destino, estado de creatividad) más creatividades SD...
ppc_daily_trendObtén métricas día a día para análisis de tendencias
ppc_dayparting_analyticsObtén el programa de dayparting (modificador de oferta por hora del día) para el perfil
ppc_describeSin argumentos: catálogo de los conjuntos de datos PPC sin procesar detrás de ppc_query (tablas de informes diarios a nivel de campaña/grupo de anuncios/objetivo/término de búsqueda/ubicación...
ppc_harvesting_candidatesEncuentra términos de búsqueda que convierten y son elegibles para promoverse a campañas manuales
ppc_keywordsConsulta rendimiento de ofertas de palabras clave/objetivos en Sponsored Products Y Sponsored Brands (las filas llevan ad_type SP/SB; las expresiones de segmentación SD l...
ppc_match_type_breakdownObtén desglose de rendimiento por tipo de coincidencia de palabra clave (Amplia, Frase, Exacta, etc.)
ppc_negation_candidatesEncuentra términos de búsqueda que no convierten con gasto significativo: candidatos para agregar como palabras clave negativas
ppc_negativesPalabras clave negativas actuales y objetivos de producto negativos (a nivel de campaña y grupo de anuncios), con estado y fuente.
ppc_new_to_brandCompras/ventas de nuevos clientes y %NTB por campaña (SB + SD, de columnas estándar de informes: no se necesita AMC)
ppc_optimization_suggestionsAnaliza campañas y clasifícalas en mejores rendimientos (en o por debajo del ACoS objetivo), activas (significativamente por encima del objetivo) y gasto desperdiciado...
ppc_period_comparisonCompara métricas del período actual con el período anterior de igual duración
ppc_placement_modifiersModificadores de oferta de ubicación actuales por campaña (parte superior de búsqueda, páginas de producto, resto de búsqueda).
ppc_placementsObtén desglose de rendimiento por tipo de ubicación (Parte superior de búsqueda, Páginas de producto, Resto de búsqueda) de datos de ubicación SP
ppc_portfoliosObtén resumen de rendimiento a nivel de portafolio
ppc_product_familyConsulta la jerarquía de productos padre/hijo de la biblioteca de productos (informe de listado de categorías)
ppc_product_reportEL informe canónico de producto/familia: UNA llamada que devuelve cada vista etiquetada: resolución de familia, totales de anuncios precisos de ASIN (grano de anuncio SP+SD —...
ppc_queryConsulta de nivel de fila con fidelidad COMPLETA sobre cualquier conjunto de datos PPC sin procesar (ver ppc_describe): proyección de columnas, filtros (eq/neq/gt/gte/lt/lte/in/contains),...
ppc_search_termsConsulta datos de rendimiento de términos de búsqueda

Automatización

HerramientaQué hace
automation_activityLA bandeja de aprobación para la automatización de reglas V2: la ÚNICA superficie para aprobaciones de automatización pendientes (las herramientas MinMax/AOE/tareas programadas son separa...
automation_aoe_statusMotor de Optimización Adaptativa: configuraciones por campaña, modos, salvaguardas y ciclos de optimización recientes
automation_daypartingSegmentación por franjas horarias, SOLO LECTURA: action=list muestra horarios + asignaciones (las mutaciones viven en stage_dayparting_schedule).
automation_minmax_resultsEjecuciones recientes de análisis de presupuesto MinMax: alcance, mejores rendimientos, campañas activas
automation_recent_tasksObtén la lista de tareas de automatización programadas con su estado, cadencia y resultados de la última ejecución.
automation_rulesAutomatización basada en reglas V2, SOLO LECTURA: action=list|get|dry_run (las mutaciones viven en stage_automation_rule)
automation_scheduled_tasksTareas programadas: tipo, cadencia, estado habilitado, última y próxima ejecución

Contenido A+

HerramientaQué hace
aplus_documentObtén UN documento de contenido A+ EN VIVO, incluida su lista completa de contentModuleList: la fuente de copia para ediciones (el conjunto de datos aplus_content contiene met...

Escrituras en etapas (nada llega a Amazon hasta que confirmes)

HerramientaQué hace
cancel_staged_changesCancela una propuesta pendiente sin ejecutarla.
confirm_staged_changesEJECUTA una propuesta pendiente: llámalo SOLO después de haber mostrado el diff completo al usuario como texto (entidades por nombre, actual → propuesto, r...
stage_ad_group_createCrea un nuevo grupo de anuncios SP en una campaña existente (nombre + oferta predeterminada; se crea HABILITADO)
stage_ad_group_updateRenombra un grupo de anuncios (SP/SB) o cambia su oferta predeterminada (solo SP: los grupos de anuncios SB no tienen oferta predeterminada)
stage_aplus_updateCrea o actualiza un documento de contenido A+ (EBC/Premium), opcionalmente adjunta ASINs y envíalo para aprobación de Amazon
stage_asset_uploadSube una IMAGEN o VIDEO a la Biblioteca de Activos Creativos: desde una source_url pública o desde un staged_file_id (carga por navegador vía ppc_ass...
stage_automation_reviewEtapa una decisión sobre elementos de la bandeja de aprobación de automatización (consulta automation_activity para la bandeja en sí): action=approve|reject|undo, cada una toma...
stage_automation_ruleEtapa una mutación de regla: action=create|update|delete|toggle|duplicate|assign|unassign|run_now
stage_bid_changesPropone cambios de oferta en palabras clave/objetivos SP + SB + SD que coincidan con filtros (ad_type limita a un programa)
stage_budget_changesPropone cambios en el presupuesto diario de campañas SP
stage_campaign_createCrea campañas de Sponsored Products, Sponsored Brands o Sponsored Display de principio a fin
stage_campaign_tagsEtiqueta/anota una campaña en AMZ Vault (add_tags / remove_tags / note): metadatos puros, nada se envía a Amazon
stage_campaign_updateActualiza campañas: nombre, budget_amount, budget_type (LIFETIME es solo SB), bidding_strategy, start_date / end_date (AAAA-MM-DD; end_d nulo...
stage_cogs_updatePropone establecer costos aterrizados por SKU (COGS), con versionado por tiempo
stage_competitor_watchlistPropone agregar/eliminar ASINs de competidores en la lista de seguimiento de insights de reseñas
stage_dayparting_scheduleEtapa una mutación de segmentación por franjas horarias: action=create|update|delete|toggle|clone|assign|unassign
stage_entity_statusPausa/habilita/archiva entidades específicas POR ID: grupos de anuncios, anuncios de producto, palabras clave, objetivos o campañas (complementa la etapa basada en filtros...
stage_listing_updateActualiza contenido EN VIVO de listados de Amazon: título, bullet_points (lista de reemplazo completa), descripción, search_terms (palabras clave de backend, ~249 bytes...
stage_margin_targetPropone un objetivo de margen BE (punto de equilibrio) manual para una familia de productos (be_margin_pct nulo lo limpia para que se aplique el punto de equilibrio calculado)
stage_negativesPropone agregar palabras clave negativas / objetivos ASIN negativos
stage_negatives_removeELIMINA (archiva) palabras clave negativas / objetivos de producto negativos por sus ids locales de ppc_negatives: la otra mitad de la gestión de negaciones
stage_po_upsertPropone crear o actualizar órdenes de compra (coincidentes por po_number por conexión): supplier_name (creado si es nuevo), estado/fecha de hito...
stage_portfolio_createCrea un nuevo portafolio (sin límite de presupuesto; establece presupuestos después vía stage_portfolio_update, incl
stage_portfolio_updateActualiza un portafolio: nombre, budget_amount, budget_policy (DATE_RANGE/MONTHLY_RECURRING/"remove"), budget_start_date, budget_end_date
stage_product_ad_addAgrega productos anunciados a un grupo de anuncios SP o SD existente (campaign_type, SP predeterminado): se crea HABILITADO
stage_product_editPropone editar un campo de la Biblioteca de Productos (lo bloquea contra sincronizaciones futuras)
stage_status_changePropone habilitar/pausar campañas que coincidan con filtros
stage_supplier_upsertPropone crear o actualizar proveedores (coincidentes por nombre por conexión): contactos, términos de pago y los tiempos de producción/tránsito que...
stage_targeting_addAgrega palabras clave, objetivos de producto ASIN y/o objetivos de categoría a una campaña + grupo de anuncios EXISTENTE (SP o SB): p. ej.
staged_changes_pendingLista las propuestas pendientes (sin confirmar) de esta cuenta.

Otros

HerramientaQué hace
forecast_reorder_reportAsesor de reordenamiento para una conexión de vendedor: fechas de agotamiento por ASIN del pronóstico más reciente (contando FBA + AWD + entrante + órdenes de compra abiertas...
forecast_reportEL pronóstico de unidades por ASIN a 12 meses (motor nocturno): totales de marca vs. año anterior, índice de estacionalidad, diagnósticos incl.
workforce_check_inRegístrate con la Fuerza Laboral de IA de AMZ Vault y recibe el siguiente paquete de trabajo del trabajador
workforce_reportEnvía los resultados de un paquete de trabajo de la fuerza laboral
workforce_statusVista de solo lectura de la Fuerza Laboral de IA: roles contratados, profundidad de cola, cambios en etapas pendientes de aprobación en el panel, asesor de uso y ejecuciones recientes

Qué NO es esto

  • No es un piloto automático. Ninguna escritura llega a Amazon sin tu confirmación explícita del diff en etapas, nunca.
  • No es un raspador. Todos los datos provienen de la API oficial de Selling Partner de Amazon y la API de Amazon Ads a través de tu propia conexión autorizada.
  • No es un servidor local. El servidor MCP está alojado; este repositorio existe para que los registros y directorios puedan listarlo. No hay nada que npm install.
  • No es gratis para siempre. El conector viene con cada prueba y suscripción de AMZ Vault. La demo en vivo es gratuita y no requiere registro.

Seguridad y privacidad

  • OAuth 2.1 con registro dinámico de clientes y consentimiento por cliente; revoca el token de cualquier cliente en cualquier momento desde Configuración.
  • Los miembros del equipo se conectan con sus propias cuentas y ven exactamente lo que sus permisos les permiten: los permisos se resuelven en vivo en cada llamada.
  • Las operaciones destructivas se marcan por separado, y las dos que existen requieren la misma confirmación explícita que todo lo demás.
  • La Política de Agentes de IA de Amazon de marzo de 2026, y cómo AMZ Vault la cumple: amz-vault.com/blog/amazon-ai-agent-policy

Enlaces