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
También publicado en el Registro MCP oficial como io.github.TheBurdz/amz-vault, y listado en el directorio de conectores de Claude, Smithery y mcpservers.org.
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. Sin claves API que crear, copiar o filtrar.
- Escrituras: cada cambio se PREPARA (staged). 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 alojado de AMZ Vault. El servidor se ejecuta en amz-vault.com; no hay código que instalar ni 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 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 preparadas con aprobación humana. Cambios de ofertas, 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 un 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 reordenes 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 prepara negativos 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, dada la velocidad actual y los tiempos de entrega?"
- "Prepara una reducción de oferta del 15% en 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-22: 110 herramientas (4 herramientas adicionales de AI Workforce aparecen una vez que un cliente está conectado). 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|... |
account_health_check | Incorporación por conexión + estado de sincronización en TODOS los tenants (SOLO SUPER-ADMIN) |
account_help | Busca y lee el Centro de Ayuda de AMZ Vault: los mismos artículos que los usuarios ven en /help: configuración, conexiones y semántica de datos, plataforma por página... |
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, cosecha... |
account_notice_draft | Poner en cola un correo de aviso único a un usuario para revisión del administrador (SOLO ADMIN) |
account_ops_events | Fuente de salud operativa (SOLO ADMIN): errores / advertencias / eventos de limitación de API deduplicados del worker y los servicios web con conteo de ocurrencias... |
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 sobre esta cuenta: action=grant permite que el soporte vea lo que el usuario ve durante 7 días... |
Data warehouse
| Herramienta | Qué hace |
|---|---|
data_describe | Sin argumentos: lista cada conjunto de datos del warehouse disponible para data_query |
data_freshness | Frescura de sincronización por conjunto de datos, conteos de filas, cobertura de fechas y progreso de backfill: úsalo para matizar las respuestas correctamente |
data_query | Consulta genérica sobre cualquier conjunto de datos del warehouse (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 → beneficio bruto → tarifas de Amazon → margen de contribución → publicidad → beneficio neto... |
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 mini-tarjetas de 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, conteo 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 Pérdidas y Ganancias para una ventana de fechas: tarjetas de cuenta (ventas, tarifas, COGS, gasto en anuncios, beneficio bruto, margen de contribución, beneficio neto, TACoS... |
Productos e inventario
| Herramienta | Qué hace |
|---|---|
inventory_health | Unidades FBA disponibles/en tránsito/reservadas, inventario envejecido, recomendaciones de reposición y grupo AWD por SKU |
inventory_shipment_tracking | Seguimiento de cadena de suministro en vivo (SP-API Tracking, solo tienda EE. UU.): hitos y estimaciones para un envío en movimiento a través de Amazon: pasa UN solo ide... |
product_cogs | Costos landed actuales por SKU (COGS) y resumen de cobertura. |
product_fee_preview | Tarifas estimadas propias de Amazon por SKU para las próximas semanas (referral, 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 cuotas de combinación). |
brand_repeat_purchase | Lealtad del cliente por ASIN: cuota 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 cuotas |
brand_store_analytics | Rendimiento de Brand Store (Stores Analytics API): view='insights' = tráfico/ventas de la tienda por FECHA / PÁGINA / FUENTE / TIENDA / ETIQUETA (visitas, visi... |
brand_top_search_terms | Términos de búsqueda principales a nivel de marketplace con los 3 ASIN más clickeados y sus cuotas de clic/conversión |
Inteligencia de palabras clave
| Herramienta | Qué hace |
|---|---|
keyword_finder | Buscador de palabras clave (búsqueda inversa por 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... |
keyword_opportunities | PUERTA PRINCIPAL de investigación de KW: comienza aquí para cualquier pregunta de palabras clave sobre un producto (nuevo o establecido) |
keyword_research | Investigación de palabras clave (universo de términos del marketplace): busca en la tienda COMPLETA de Top Search Terms por frase: no anclada a ningún ASIN |
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 anuncios SP+SD, fusionado por ASIN con desglose por programa; el gasto por ASIN de SB solo existe en el blen... |
ppc_asset_upload_link | Genera un enlace de carga en el navegador de 1 hora para que el USUARIO pueda entregar un archivo local (los adjuntos del chat no pueden llegar al servidor) |
ppc_bid_recommendations | Oferta sugerida de Amazon + rango por palabra clave para una campaña ESPECÍFICA (enrutado por tipo de campaña) |
ppc_budget_alerts | Encuentra campañas que se acercan o superan su presupuesto diario - MISMO DÍA donde fluyen los datos de Marketing Stream (las filas de signal_source=stream son mi... |
ppc_campaign_create_guide | El contrato verificado para crear campañas mediante stage_campaign_create: campos obligatorios 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, incluyendo ubicaciones, ASINs 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 mostrando 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, logo de marca, imágenes personalizadas, IDs de activos de video, ASINs, 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 | Programa de franjas horarias Y rendimiento real por hora del día |
ppc_describe | Sin argumentos: catálogo de los conjuntos de datos PPC brutos 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 promoción 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 concordancia 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 de marca y NTB% por campaña (SB + SD, de columnas estándar de informes — sin necesidad de AMC) |
ppc_optimization_suggestions | Analiza campañas y clasifícalas en mejores rendimientos (en o por debajo del ACoS objetivo), en caliente (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) a partir 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 desde 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 asin_accurate (grano de anuncios SP+SD —... |
ppc_query | Consulta de nivel de fila de FIDELIDAD COMPLETA sobre cualquier conjunto de datos PPC bruto (ver ppc_describe): proyección de columnas, filtros (eq/neq/gt/gte/lt/lte/in/contains),... |
ppc_recommendations | Recomendaciones consolidadas propias de Amazon (API unificada de Recommendations): cambios de oferta/presupuesto/estrategia de oferta, nuevas palabras clave, negativas, ta... |
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 automatización de reglas V2 — la ÚNICA superficie para aprobaciones de automatización pendientes (las herramientas de 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 | 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 en caliente |
automation_recent_tasks | Obtén la lista de tareas de automatización programadas con su estado, cadencia y resultados de ú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, últimas y próximas horas de ejecución |
Contenido A+
| Herramienta | Qué hace |
|---|---|
aplus_document | Obtén UN documento de contenido A+ EN VIVO, incluyendo su contentModuleList completo — 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 — llama 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; creado 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ía 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 en navegador vía ppc_ass... |
stage_automation_review | Prepara una decisión sobre elementos de la bandeja de aprobación de automatización (ver automation_activity para la bandeja en sí): action=approve|reject|undo, cada ta... |
stage_automation_rule | Prepara 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 reduce a un programa) |
stage_budget_changes | Propone cambios de 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 (YYYY-MM-DD; end_d nulo... |
stage_cogs_update | Propone establecer costos de aterrizaje 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 | Prepara una mutación de 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 el stage basado en filtros... |
stage_listing_update | Actualiza contenido EN VIVO de listados de Amazon: título, bullet_points (lista completa de reemplazo), descripción, search_terms (palabras clave 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 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) — creado 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 entrega de producción/tránsito t... |
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 reorden 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 o... |
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 |
Lo que esto NO es
- No es un piloto automático. Ninguna escritura llega a Amazon sin tu confirmación explícita del diff en etapas, siempre.
- 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 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 accesos les permiten — los accesos se resuelven en vivo en cada llamada.
- Las operaciones destructivas están marcadas 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 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