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)
- 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).
- En Claude: Configuración -> Conectores -> Agregar conector personalizado y pega
https://www.amz-vault.com/mcp. - Claude abre la pantalla de inicio de sesión y consentimiento de AMZ Vault. Aprueba.
- 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
| Cliente | Cómo |
|---|---|
| Claude (web / escritorio) | Configuración -> Conectores -> Agregar conector personalizado -> https://www.amz-vault.com/mcp |
| Claude Code | claude mcp add --transport http amz-vault https://www.amz-vault.com/mcp |
| Cursor | Configuració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 |
| Windsurf | Agregar a mcp_config.json: {"mcpServers": {"amz-vault": {"serverUrl": "https://www.amz-vault.com/mcp"}}} |
| Cualquier otra cosa | Cualquier 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
| Herramienta | Qué hace |
|---|---|
account_feedback | Canal 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_guide | El 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_profiles | Lista los perfiles publicitarios (cuentas de PPC) conectados a las conexiones de vendedor de este token. |
account_report | LA 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_sellers | Lista las conexiones de vendedor de Amazon a las que este token puede acceder, con sus marketplaces y monedas. |
account_support_access | Otorga 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
| Herramienta | Qué hace |
|---|---|
data_describe | Sin argumentos: lista cada conjunto de datos del almacén disponible para data_query |
data_freshness | Frescura de sincronización por conjunto de datos, recuentos de filas, cobertura de fechas y progreso de relleno: úsalo para advertir correctamente las respuestas |
data_query | Consulta 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
| Herramienta | Qué hace |
|---|---|
pnl_breakdown | Cascada de cuenta basada en liquidaciones: ingresos → reembolsos → COGS → ganancia bruta → tarifas de Amazon → margen de contribución → publicidad → ganancia neta... |
pnl_by_asin | Filas de P&L por ASIN para una ventana de fechas (opcionalmente un ASIN): ventas, unidades, tarifas, COGS, márgenes, TACoS, stock. |
pnl_expenses | Gastos operativos personalizados (suscripciones, VA, flete, 3PL…): alcance, recurrencia, montos. |
pnl_mcf_summary | Totales de Multi-Channel Fulfillment (fuera de Amazon): unidades, pedidos, tarifas de cumplimiento y COGS para una ventana. |
pnl_period_cards | Las tarjetas mini-P&L del panel (Hoy / Ayer / MTD / Pronóstico de este mes / Mes pasado). |
pnl_refunds | Componentes de reembolso para una ventana: monto neto de reembolso, recuento y líneas detalladas (reembolsos, reposición de stock). |
pnl_sb_attribution | Atribució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_audit | Auditorí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_summary | Resumen 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
| Herramienta | Qué hace |
|---|---|
inventory_health | Unidades FBA cumplibles/entrantes/reservadas, inventario envejecido, recomendaciones de reposición y grupo AWD por SKU |
product_cogs | Costos actuales por SKU en tierra (COGS) y resumen de cobertura. |
product_fee_preview | Tarifas estimadas propias de Amazon por SKU para las próximas semanas (referido, cumplimiento, almacenamiento). |
product_library | El catálogo de productos canónico con ACoS de punto de equilibrio y objetivos de margen BE efectivos por familia de productos. |
Brand Analytics
| Herramienta | Qué hace |
|---|---|
brand_market_basket | Lo que los clientes compran junto con cada ASIN (pares comprados juntos y participaciones de combinación). |
brand_repeat_purchase | Lealtad del cliente por ASIN: participación de compradores recurrentes e ingresos recurrentes por semana. |
brand_search_catalog | Totales del embudo de búsqueda por ASIN en TODAS las consultas (SQP sin consulta): impresiones, clics, agregados al carrito, compras, precios medios. |
brand_sqp | Rendimiento 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_terms | Té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
| Herramienta | Qué hace |
|---|---|
keyword_finder | Buscador 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
| Herramienta | Qué hace |
|---|---|
ppc_account_summary | Obtén métricas agregadas a nivel de cuenta para un rango de fechas: gasto total, ventas, ACoS, ROAS, clics, impresiones, compras. |
ppc_ad_groups | Consulta datos de rendimiento de grupos de anuncios dentro de campañas |
ppc_ad_type_breakdown | Obtén comparación de rendimiento entre tipos de anuncios (SP vs SB vs SD) |
ppc_advertised_products | Consulta 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_link | Genera 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_recommendations | Oferta sugerida de Amazon + rango por palabra clave para una campaña ESPECÍFICA (enrutada por tipo de campaña) |
ppc_budget_alerts | Encuentra campañas que se acercan o superan su presupuesto diario |
ppc_campaign_create_guide | El 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_details | Obtén datos detallados para campañas SP específicas, incluidas ubicaciones, ASIN anunciados, modificadores de ubicación y palabras clave/objetivos principales |
ppc_campaign_metadata | Configuración de campaña y metadatos de usuario: estrategia de oferta, configuración de ubicación, objetivo/KPI, etiquetas, notas. |
ppc_campaign_search | Búsqueda ligera de nombres de campaña |
ppc_campaigns | Consulta datos de rendimiento de campañas con filtros opcionales |
ppc_change_history | Obtén historial reciente de cambios de campaña que muestre qué cambió, cuándo, valores antiguos y valores nuevos |
ppc_conversion_funnel | Obtén datos del embudo de conversión: Impresiones → Clics → Pedidos con tasas entre cada etapa |
ppc_creatives | Creatividades 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_trend | Obtén métricas día a día para análisis de tendencias |
ppc_dayparting_analytics | Obtén el programa de dayparting (modificador de oferta por hora del día) para el perfil |
ppc_describe | Sin 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_candidates | Encuentra términos de búsqueda que convierten y son elegibles para promoverse a campañas manuales |
ppc_keywords | Consulta 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_breakdown | Obtén desglose de rendimiento por tipo de coincidencia de palabra clave (Amplia, Frase, Exacta, etc.) |
ppc_negation_candidates | Encuentra términos de búsqueda que no convierten con gasto significativo: candidatos para agregar como palabras clave negativas |
ppc_negatives | Palabras clave negativas actuales y objetivos de producto negativos (a nivel de campaña y grupo de anuncios), con estado y fuente. |
ppc_new_to_brand | Compras/ventas de nuevos clientes y %NTB por campaña (SB + SD, de columnas estándar de informes: no se necesita AMC) |
ppc_optimization_suggestions | Analiza 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_comparison | Compara métricas del período actual con el período anterior de igual duración |
ppc_placement_modifiers | Modificadores de oferta de ubicación actuales por campaña (parte superior de búsqueda, páginas de producto, resto de búsqueda). |
ppc_placements | Obté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_portfolios | Obtén resumen de rendimiento a nivel de portafolio |
ppc_product_family | Consulta la jerarquía de productos padre/hijo de la biblioteca de productos (informe de listado de categorías) |
ppc_product_report | EL 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_query | Consulta 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_terms | Consulta datos de rendimiento de términos de búsqueda |
Automatización
| Herramienta | Qué hace |
|---|---|
automation_activity | LA 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_status | Motor de Optimización Adaptativa: configuraciones por campaña, modos, salvaguardas y ciclos de optimización recientes |
automation_dayparting | Segmentación por franjas horarias, SOLO LECTURA: action=list muestra horarios + asignaciones (las mutaciones viven en stage_dayparting_schedule). |
automation_minmax_results | Ejecuciones recientes de análisis de presupuesto MinMax: alcance, mejores rendimientos, campañas activas |
automation_recent_tasks | Obtén la lista de tareas de automatización programadas con su estado, cadencia y resultados de la última ejecución. |
automation_rules | Automatización basada en reglas V2, SOLO LECTURA: action=list|get|dry_run (las mutaciones viven en stage_automation_rule) |
automation_scheduled_tasks | Tareas programadas: tipo, cadencia, estado habilitado, última y próxima ejecución |
Contenido A+
| Herramienta | Qué hace |
|---|---|
aplus_document | Obté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)
| Herramienta | Qué hace |
|---|---|
cancel_staged_changes | Cancela una propuesta pendiente sin ejecutarla. |
confirm_staged_changes | EJECUTA 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_create | Crea un nuevo grupo de anuncios SP en una campaña existente (nombre + oferta predeterminada; se crea HABILITADO) |
stage_ad_group_update | Renombra un grupo de anuncios (SP/SB) o cambia su oferta predeterminada (solo SP: los grupos de anuncios SB no tienen oferta predeterminada) |
stage_aplus_update | Crea o actualiza un documento de contenido A+ (EBC/Premium), opcionalmente adjunta ASINs y envíalo para aprobación de Amazon |
stage_asset_upload | Sube 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_review | Etapa 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_rule | Etapa una mutación de regla: action=create|update|delete|toggle|duplicate|assign|unassign|run_now |
stage_bid_changes | Propone cambios de oferta en palabras clave/objetivos SP + SB + SD que coincidan con filtros (ad_type limita a un programa) |
stage_budget_changes | Propone cambios en el presupuesto diario de campañas SP |
stage_campaign_create | Crea campañas de Sponsored Products, Sponsored Brands o Sponsored Display de principio a fin |
stage_campaign_tags | Etiqueta/anota una campaña en AMZ Vault (add_tags / remove_tags / note): metadatos puros, nada se envía a Amazon |
stage_campaign_update | Actualiza 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_update | Propone establecer costos aterrizados por SKU (COGS), con versionado por tiempo |
stage_competitor_watchlist | Propone agregar/eliminar ASINs de competidores en la lista de seguimiento de insights de reseñas |
stage_dayparting_schedule | Etapa una mutación de segmentación por franjas horarias: action=create|update|delete|toggle|clone|assign|unassign |
stage_entity_status | Pausa/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_update | Actualiza 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_target | Propone 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_negatives | Propone agregar palabras clave negativas / objetivos ASIN negativos |
stage_negatives_remove | ELIMINA (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_upsert | Propone 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_create | Crea un nuevo portafolio (sin límite de presupuesto; establece presupuestos después vía stage_portfolio_update, incl |
stage_portfolio_update | Actualiza un portafolio: nombre, budget_amount, budget_policy (DATE_RANGE/MONTHLY_RECURRING/"remove"), budget_start_date, budget_end_date |
stage_product_ad_add | Agrega productos anunciados a un grupo de anuncios SP o SD existente (campaign_type, SP predeterminado): se crea HABILITADO |
stage_product_edit | Propone editar un campo de la Biblioteca de Productos (lo bloquea contra sincronizaciones futuras) |
stage_status_change | Propone habilitar/pausar campañas que coincidan con filtros |
stage_supplier_upsert | Propone 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_add | Agrega 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_pending | Lista las propuestas pendientes (sin confirmar) de esta cuenta. |
Otros
| Herramienta | Qué hace |
|---|---|
forecast_reorder_report | Asesor 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_report | EL 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_in | Regístrate con la Fuerza Laboral de IA de AMZ Vault y recibe el siguiente paquete de trabajo del trabajador |
workforce_report | Envía los resultados de un paquete de trabajo de la fuerza laboral |
workforce_status | Vista 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
- Sitio web: amz-vault.com
- Demo en vivo (sin registro): amz-vault.com/demo
- Documentación de herramientas: amz-vault.com/docs
- Habilidades gratuitas de Claude construidas sobre este conector: amz-vault.com/skills
- Soporte: amz-vault.com -> Comentarios y soporte, o la propia herramienta
account_feedback