AMZ Vault

Amazon Seller Central + Ads: P&L preciso por liquidação, PPC completo, cada gravação em etapas para aprovação.

Documentação

AMZ Vault MCP

Conecte o Claude (ou qualquer cliente de IA compatível com MCP) diretamente aos seus dados do Amazon Seller Central e Amazon Ads — lucratividade real, desempenho de PPC em cada granularidade, inventário, previsões e alterações seguras com aprovação.

Endpoint: https://www.amz-vault.com/mcp (HTTP Streamable)
Autenticação: OAuth 2.1 com registro dinâmico de cliente — faça login com sua conta AMZ Vault quando seu cliente de IA solicitar. Sem chaves de API para criar, copiar ou vazar.
Escritas: toda alteração é ENCENADA. Nada chega à Amazon até você revisar o diff e confirmar.

Este repositório é a listagem pública do servidor MCP AMZ Vault hospedado. O servidor em si roda em amz-vault.com — não há código para instalar ou executar a partir daqui.

Início rápido (Claude)

Crie uma conta AMZ Vault em amz-vault.com e conecte sua conta Amazon (teste gratuito de 14 dias, sem cartão de crédito).
No Claude: Configurações -> Conectores -> Adicionar conector personalizado e cole https://www.amz-vault.com/mcp.
O Claude abre a tela de login e consentimento do AMZ Vault. Aprove.
Pergunte: "Quão lucrativa foi minha conta no mês passado, após todas as taxas?"

Quer experimentar as ferramentas antes de conectar sua própria conta? A demonstração ao vivo roda em uma conta de vendedor sintética e não exige cadastro.

O que torna diferente

Lucro com base em liquidação, não estimativas de painel. As ferramentas de P&L reconciliam pedidos, reembolsos, todas as classes de taxas da Amazon, COGS e suas despesas operacionais com dados reais de liquidação — o número com o qual sua conta bancária concorda.
Respostas na granularidade certa. Perguntas sobre produtos recebem respostas na granularidade de produto, perguntas sobre campanhas recebem respostas na granularidade de campanha, e cada resposta é rotulada com seu escopo para que o gasto de campanhas compartilhadas nunca seja contado duas vezes.
Escritas encenadas com aprovação humana. Alterações de lance, negativas, orçamentos, criação de campanhas, edições de listagem — a IA propõe, você vê o diff exato, e somente sua confirmação executa. Não existe modo de escrita autônoma.
A conta inteira, não apenas anúncios. PPC, desempenho de busca orgânica (SQP), Brand Analytics, inventário e reposição, MCF, conteúdo A+, previsão por ASIN e planejamento de reabastecimento em um único conector.

Exemplos de prompts

"Quais produtos perderam dinheiro no mês passado após todas as taxas e gastos com anúncios?"
"Encontre termos de busca que estão gastando sem gerar pedidos e prepare negativas para minha aprovação."
"Compare meu desempenho de SP vs SB vs SD neste trimestre."
"Para quais palavras-chave o ASIN do meu principal concorrente está ranqueando e eu não estou lendo?"
"Quando preciso reabastecer cada SKU, considerando a velocidade atual e os prazos de entrega?"
"Prepare uma redução de 15% no lance para cada alvo acima de 60% de ACoS nos últimos 30 dias — mostre a lista primeiro."

Configuração do cliente

Cliente	Como
Claude (web / desktop)	Configurações -> Conectores -> Adicionar conector personalizado -> `https://www.amz-vault.com/mcp`
Claude Code	`claude mcp add --transport http amz-vault https://www.amz-vault.com/mcp`
Cursor	Configurações -> MCP -> Adicionar servidor -> digite `streamable-http`, URL `https://www.amz-vault.com/mcp`
VS Code (Copilot)	`MCP: Add Server` na paleta de comandos -> HTTP -> `https://www.amz-vault.com/mcp`
Windsurf	Adicione em `mcp_config.json`: `{"mcpServers": {"amz-vault": {"serverUrl": "https://www.amz-vault.com/mcp"}}}`
Qualquer outro	Qualquer cliente que fale MCP Streamable HTTP + OAuth 2.1 funciona. Os metadados são descobertos em `/.well-known/oauth-protected-resource/mcp`.

No primeiro uso, todo cliente passa pela mesma tela de login e consentimento OAuth — aprove uma vez por cliente e você estará conectado.

Catálogo de ferramentas

Gerado a partir do registro de ferramentas ao vivo em 2026-09-05. A referência sempre atual, incluindo documentação completa de parâmetros, está em amz-vault.com/docs.

Conta e descoberta

Ferramenta	O que faz
`account_feedback`	Canal de feedback e suporte para a equipe AMZ Vault (NÃO é uma escrita na Amazon): action=submit abre um tópico (assunto, corpo, categoria bug\|ideia\|qu...
`account_management_guide`	A estrutura de decisão de marca e PPC do operador: espinha de margem (PPD + faixas de margem), posturas de produto, estrutura de campanha/lances, colheita...
`account_profiles`	Lista os perfis de publicidade (contas PPC) conectados às conexões de vendedor deste token.
`account_report`	A visão canônica da conta — UMA chamada: cartões de período + cascata de liquidação + avisos de atualização para os conjuntos de dados financeiros, com quote_rules
`account_sellers`	Lista as conexões de vendedor Amazon que este token pode acessar, com seus marketplaces e moedas.
`account_support_access`	Concede ou revoga a visão SOMENTE-LEITURA da equipe de suporte AMZ Vault nesta conta: action=grant permite que o suporte veja o que o usuário vê por 7 dias...

Data warehouse

Ferramenta	O que faz
`data_describe`	Sem argumentos: lista todos os conjuntos de dados do warehouse disponíveis para data_query
`data_freshness`	Atualização de sincronização por conjunto de dados, contagens de linhas, cobertura de datas e progresso de backfill — use para qualificar respostas corretamente
`data_query`	Consulta genérica sobre qualquer conjunto de dados do warehouse (veja data_describe): projeção de colunas, filtros (eq/neq/gt/gte/lt/lte/in/contains), limites de data,...

P&L / lucratividade

Ferramenta	O que faz
`pnl_breakdown`	Cascata de conta com base em liquidação: receita → reembolsos → COGS → lucro bruto → taxas Amazon → margem de contribuição → publicidade → lucro líquido...
`pnl_by_asin`	Linhas de P&L por ASIN para um intervalo de datas (opcionalmente um ASIN): vendas, unidades, taxas, COGS, margens, TACoS, estoque.
`pnl_expenses`	Despesas operacionais personalizadas (assinaturas, VA, frete, 3PL…): escopo, recorrência, valores.
`pnl_mcf_summary`	Totais de Multi-Channel Fulfillment (fora da Amazon): unidades, pedidos, taxas de fulfillment e COGS para um intervalo.
`pnl_period_cards`	Os cartões mini-P&L do painel (Hoje / Ontem / MTD / Previsão deste mês / Mês passado).
`pnl_refunds`	Componentes de reembolso para um intervalo: valor líquido de reembolso, contagem e linhas detalhadas (reembolsos, reestocagem).
`pnl_sb_attribution`	Atribuição de custo de Sponsored Brands por ASIN (a divisão ponderada por vendas do gasto de SB no nível de campanha).
`pnl_settlement_audit`	Auditoria de taxas de liquidação: cada combinação distinta de taxas que a Amazon cobrou, classificada em buckets de P&L — verifique se nada está mal classificado ou...
`pnl_summary`	Resumo de Lucro e Perda para um intervalo de datas: cartões da conta (vendas, taxas, COGS, gasto com anúncios, lucro bruto, margem de contribuição, lucro líquido, TACoS...

Produtos e inventário

Ferramenta	O que faz
`inventory_health`	Unidades FBA disponíveis/em trânsito/reservadas, inventário envelhecido, recomendações de reposição e pool AWD por SKU
`product_cogs`	Custos atuais por SKU no chão de fábrica (COGS) e resumo de cobertura.
`product_fee_preview`	Taxas estimadas da própria Amazon por SKU para as próximas semanas (referral, fulfillment, armazenamento).
`product_library`	O catálogo de produtos canônico com ACoS de equilíbrio e metas de margem BE efetivas por família de produtos.

Brand analytics

Ferramenta	O que faz
`brand_market_basket`	O que os clientes compram junto com cada ASIN (pares comprados juntos e participações de combinação).
`brand_repeat_purchase`	Lealdade do cliente por ASIN: participação de compradores recorrentes e receita recorrente por semana.
`brand_search_catalog`	Totais do funil de busca por ASIN em TODAS as consultas (SQP sem consulta): impressões, cliques, adições ao carrinho, compras, preços medianos.
`brand_sqp`	Desempenho de consulta de busca: funil de busca orgânica por (ASIN, consulta) — impressões/cliques/adições ao carrinho/compras com participações
`brand_top_search_terms`	Principais termos de busca do marketplace com os 3 ASINs mais clicados e suas participações de clique/conversão

Inteligência de palavras-chave

Ferramenta	O que faz
`keyword_finder`	Localizador de palavras-chave (busca reversa por ASIN / múltiplas entradas): cada frase de palavra-chave pela qual os ASINs de entrada são conhecidos, mesclada de dados de primeira parte — SQ...

PPC — leitura

Ferramenta	O que faz
`ppc_account_summary`	Obter métricas agregadas no nível da conta para um intervalo de datas: gasto total, vendas, ACoS, ROAS, cliques, impressões, compras.
`ppc_ad_groups`	Consultar dados de desempenho de grupos de anúncios dentro de campanhas
`ppc_ad_type_breakdown`	Obter comparação de desempenho entre tipos de anúncio (SP vs SB vs SD)
`ppc_advertised_products`	Consultar desempenho no nível de produto/ASIN (granularidade de anúncio SP+SD, mesclado por ASIN com divisão por programa; gasto por ASIN de SB existe apenas no blen...
`ppc_asset_upload_link`	Gerar um link de upload de navegador com validade de 1 hora para o USUÁRIO enviar um arquivo local (anexos de chat não alcançam o servidor)
`ppc_bid_recommendations`	Lance sugerido pela Amazon + intervalo por palavra-chave para uma campanha ESPECÍFICA (roteado por tipo de campanha)
`ppc_budget_alerts`	Encontrar campanhas se aproximando ou excedendo seu orçamento diário
`ppc_campaign_create_guide`	O contrato verificado para criar campanhas via stage_campaign_create: campos obrigatórios por formato, metas, regras de página de destino, fontes de ativos...
`ppc_campaign_details`	Obter dados detalhados para campanhas SP específicas, incluindo posicionamentos, ASINs anunciados, modificadores de posicionamento e principais palavras-chave/alvos
`ppc_campaign_metadata`	Configuração de campanha e metadados do usuário: estratégia de lance, configurações de posicionamento, meta/KPI, tags, notas.
`ppc_campaign_search`	Consulta leve de nomes de campanhas
`ppc_campaigns`	Consultar dados de desempenho de campanhas com filtros opcionais
`ppc_change_history`	Obter histórico recente de alterações de campanha mostrando o que mudou, quando, valores antigos e novos valores
`ppc_conversion_funnel`	Obter dados do funil de conversão: Impressões → Cliques → Pedidos com taxas entre cada etapa
`ppc_creatives`	Criativos de anúncio SB na granularidade de anúncio (título, logotipo da marca, imagens personalizadas, IDs de vídeo, ASINs, página de destino, status do criativo) além de criativos SD...
`ppc_daily_trend`	Obter métricas dia a dia para análise de tendências
`ppc_dayparting_analytics`	Obter o agendamento de dayparting (modificador de lance por hora do dia) para o perfil
`ppc_describe`	Sem argumentos: catálogo dos conjuntos de dados PPC brutos por trás de ppc_query (tabelas de relatórios diários em campanha/grupo de anúncios/alvo/termo de busca/posicionamento...
`ppc_harvesting_candidates`	Encontrar termos de busca que convertem e são elegíveis para promoção a campanhas manuais
`ppc_keywords`	Consultar desempenho de lance de palavra-chave/alvo em Sponsored Products E Sponsored Brands (linhas carregam ad_type SP/SB; expressões de segmentação SD l...
`ppc_match_type_breakdown`	Obter detalhamento de desempenho por tipo de correspondência de palavra-chave (Ampla, Frase, Exata, etc.)
`ppc_negation_candidates`	Encontrar termos de busca que não convertem com gasto significativo — candidatos para adição de palavras-chave negativas
`ppc_negatives`	Palavras-chave negativas atuais e alvos de produto negativos (no nível de campanha e grupo de anúncios), com estado e fonte.
`ppc_new_to_brand`	Compras/vendas de novos clientes e %NTB por campanha (SB + SD, de colunas padrão de relatório — sem necessidade de AMC)
`ppc_optimization_suggestions`	Analisar campanhas e categorizar em melhores desempenhos (no alvo ou abaixo do ACoS alvo), aquecidas (significativamente acima do alvo) e gasto desperdiçado...
`ppc_period_comparison`	Comparar métricas do período atual com o período anterior de igual duração
`ppc_placement_modifiers`	Modificadores de lance de posicionamento atuais por campanha (topo da busca, páginas de produto, resto da busca).
`ppc_placements`	Obter detalhamento de desempenho por tipo de posicionamento (Topo da Busca, Páginas de Produto, Resto da Busca) a partir de dados de posicionamento SP
`ppc_portfolios`	Obter resumo de desempenho no nível de portfólio
`ppc_product_family`	Consultar hierarquia de produtos pai/filho da biblioteca de produtos (relatório de listagem por categoria)
`ppc_product_report`	O relatório canônico de produto/família — UMA chamada retornando cada visão rotulada: resolução de família, totais de anúncio asin_accurate (granularidade de anúncio SP+SD —...
`ppc_query`	Consulta no nível de linha com fidelidade TOTAL sobre qualquer conjunto de dados PPC bruto (veja ppc_describe): projeção de colunas, filtros (eq/neq/gt/gte/lt/lte/in/contains),...
`ppc_search_terms`	Consultar dados de desempenho de termos de busca

Automação

Ferramenta	O que faz
`automation_activity`	A caixa de entrada de aprovação para automação de regras V2 — a ÚNICA superfície para aprovações de automação pendentes (as ferramentas MinMax/AOE/tarefas agendadas são separa...
`automation_aoe_status`	Adaptive Optimization Engine: configurações por campanha, modos, proteções e ciclos de otimização recentes
`automation_dayparting`	Dayparting, SOMENTE LEITURA: action=list mostra cronogramas + atribuições (mutações ficam em stage_dayparting_schedule).
`automation_minmax_results`	Execuções recentes de análise de orçamento MinMax: escopo, principais performers, campanhas operando em alta
`automation_recent_tasks`	Obtenha a lista de tarefas de automação agendadas com status, cadência e resultados da última execução.
`automation_rules`	Automação baseada em regras V2, SOMENTE LEITURA: action=list\|get\|dry_run (mutações ficam em stage_automation_rule)
`automation_scheduled_tasks`	Tarefas agendadas: tipo, cadência, estado habilitado, última e próxima execução

Conteúdo A+

Ferramenta	O que faz
`aplus_document`	Busca UM documento de conteúdo A+ AO VIVO, incluindo sua contentModuleList completa — a fonte de cópia para edições (o dataset aplus_content contém met...

Gravações em estágio (nada chega à Amazon até você confirmar)

Ferramenta	O que faz
`cancel_staged_changes`	Cancela uma proposta pendente sem executá-la.
`confirm_staged_changes`	EXECUTA uma proposta pendente — chame SOMENTE após renderizar o diff completo ao usuário como texto (entidades por nome, atual → proposto, r...
`stage_ad_group_create`	Cria um novo grupo de anúncios SP em uma campanha existente (nome + lance padrão; criado HABILITADO)
`stage_ad_group_update`	Renomeia um grupo de anúncios (SP/SB) ou altera seu lance padrão (somente SP — grupos de anúncios SB não têm lance padrão)
`stage_aplus_update`	Cria ou atualiza um documento de conteúdo A+ (EBC/Premium), opcionalmente anexa ASINs e envia para aprovação da Amazon
`stage_asset_upload`	Envia uma IMAGEM ou VÍDEO para a Creative Asset Library — a partir de uma source_url pública, ou de um staged_file_id (upload via navegador com ppc_ass...
`stage_automation_review`	Prepara uma decisão sobre itens da caixa de entrada de aprovação de automação (veja automation_activity para a própria caixa): action=approve\|reject\|undo, cada uma leva...
`stage_automation_rule`	Prepara uma mutação de regra: action=create\|update\|delete\|toggle\|duplicate\|assign\|unassign\|run_now
`stage_bid_changes`	Propõe alterações de lance em palavras-chave/alvos SP + SB + SD que correspondam aos filtros (ad_type restringe a um programa)
`stage_budget_changes`	Propõe alterações no orçamento diário de campanhas SP
`stage_campaign_create`	Cria campanhas Sponsored Products, Sponsored Brands ou Sponsored Display de ponta a ponta
`stage_campaign_tags`	Marca/anota uma campanha no AMZ Vault (add_tags / remove_tags / note) — metadados puros, nada é enviado à Amazon
`stage_campaign_update`	Atualiza campanhas: nome, budget_amount, budget_type (LIFETIME é somente SB), bidding_strategy, start_date / end_date (AAAA-MM-DD; end_d nulo...
`stage_cogs_update`	Propõe definir custos landed por SKU (COGS), com versão por período
`stage_competitor_watchlist`	Propõe adicionar/remover ASINs concorrentes na lista de monitoramento de insights de avaliações
`stage_dayparting_schedule`	Prepara uma mutação de dayparting: action=create\|update\|delete\|toggle\|clone\|assign\|unassign
`stage_entity_status`	Pausa/habilita/arquiva entidades específicas POR ID: grupos de anúncios, anúncios de produto, palavras-chave, alvos ou campanhas (complementa o estágio baseado em filtros...
`stage_listing_update`	Atualiza conteúdo de listagem AO VIVO na Amazon: título, bullet_points (lista de substituição completa), descrição, search_terms (palavras-chave de backend, ~249 bytes...
`stage_margin_target`	Propõe uma meta manual de margem BE (breakeven) para uma família de produtos (be_margin_pct nulo limpa para que o breakeven calculado seja aplicado)
`stage_negatives`	Propõe adicionar palavras-chave negativas / alvos ASIN negativos
`stage_negatives_remove`	REMOVE (arquiva) palavras-chave negativas / alvos de produto negativos pelos seus ids locais de ppc_negatives — a outra metade da gestão de negações
`stage_po_upsert`	Propõe criar ou atualizar ordens de compra (correspondidas por po_number por conexão): supplier_name (criado se novo), status/data de marco...
`stage_portfolio_create`	Cria um novo portfólio (sem limite de orçamento; defina orçamentos depois via stage_portfolio_update, incl
`stage_portfolio_update`	Atualiza um portfólio: nome, budget_amount, budget_policy (DATE_RANGE/MONTHLY_RECURRING/"remove"), budget_start_date, budget_end_date
`stage_product_ad_add`	Adiciona produtos anunciados a um grupo de anúncios SP ou SD existente (campaign_type, padrão SP) — criado HABILITADO
`stage_product_edit`	Propõe editar um campo da Product Library (bloqueia contra sincronizações futuras)
`stage_status_change`	Propõe habilitar/pausar campanhas que correspondam aos filtros
`stage_supplier_upsert`	Propõe criar ou atualizar fornecedores (correspondidos por nome por conexão): contatos, termos de pagamento e os prazos de produção/trânsito que...
`stage_targeting_add`	Adiciona palavras-chave, alvos de produto ASIN e/ou alvos de categoria a uma campanha + grupo de anúncios EXISTENTE (SP ou SB) — ex...
`staged_changes_pending`	Lista as propostas pendentes (não confirmadas) desta conta.

Outros

Ferramenta	O que faz
`forecast_reorder_report`	Reorder advisor para uma conexão de vendedor: datas de esgotamento por ASIN da previsão mais recente (contando FBA + AWD + inbound + ordens de compra abertas...
`forecast_report`	A previsão de unidades por ASIN de 12 meses (motor noturno): totais da marca vs ano anterior, índice de sazonalidade, diagnósticos incl...
`workforce_check_in`	Faça check-in com a AMZ Vault AI Workforce e receba o próximo pacote de trabalho
`workforce_report`	Envie os resultados de um pacote de trabalho
`workforce_status`	Visão somente leitura da AI Workforce: funções contratadas, profundidade da fila, alterações em estágio aguardando aprovação no dashboard, advisor de uso e execuções recentes

O que isto NÃO é

Não é um piloto automático. Nenhuma gravação chega à Amazon sem sua confirmação explícita do diff em estágio, jamais.
Não é um scraper. Todos os dados vêm da Selling Partner API oficial da Amazon e da Amazon Ads API através da sua própria conexão autorizada.
Não é um servidor local. O servidor MCP é hospedado; este repositório existe para que registros e diretórios possam listá-lo. Não há nada para npm install.
Não é gratuito para sempre. O conector acompanha todo trial e assinatura do AMZ Vault. A demonstração ao vivo é gratuita e não requer cadastro.

Segurança e privacidade

OAuth 2.1 com registro dinâmico de clientes e consentimento por cliente; revogue o token de qualquer cliente a qualquer momento em Configurações.
Membros da equipe conectam-se com suas próprias contas e veem exatamente o que seus acessos permitem — as permissões são resolvidas ao vivo em cada chamada.
Operações destrutivas são sinalizadas separadamente, e as duas que existem exigem a mesma confirmação explícita que todas as outras.
A Agent Policy de março de 2026 da Amazon, e como o AMZ Vault está em conformidade: amz-vault.com/blog/amazon-ai-agent-policy