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
Também publicado no Registro MCP oficial como io.github.TheBurdz/amz-vault, e listado no diretório de conectores do Claude, Smithery e mcpservers.org.
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 registro para o 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 da 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 lances, 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 pesquisa 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 pesquisa 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."
- "Por quais palavras-chave o ASIN do meu principal concorrente está ranqueando e que eu não estou licitando?"
- "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-me 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 a mcp_config.json: {"mcpServers": {"amz-vault": {"serverUrl": "https://www.amz-vault.com/mcp"}}} |
| Qualquer outra coisa | 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, cada 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 22/09/2026 — 110 ferramentas (4 ferramentas adicionais de AI Workforce aparecem quando um cliente é conectado). 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|... |
account_health_check | Onboarding por conexão + saúde de sincronização em TODOS os tenants (SOMENTE SUPER-ADMIN) |
account_help | Pesquise e leia a Central de Ajuda da AMZ Vault — os mesmos artigos que os usuários veem em /help: configuração, conexões e semântica de dados, plataforma por página... |
account_management_guide | A estrutura de decisão de marca e PPC do operador: espinha dorsal de margem (PPD + faixas de margem), posturas de produto, estrutura de campanha/licitação, colheita... |
account_notice_draft | Envie um e-mail de aviso único para um usuário para revisão do administrador (SOMENTE ADMIN) |
account_ops_events | Feed de saúde operacional (SOMENTE ADMIN): erros / avisos / eventos de limitação de API deduplicados dos serviços de worker e web com contagem de ocorrências... |
account_profiles | Liste os perfis de publicidade (contas de PPC) conectados às conexões de vendedor deste token. |
account_report | A visão geral canônica da conta — UMA chamada: cartões de período + waterfall de liquidação + avisos de atualização para os conjuntos de dados financeiros, com quote_rules |
account_sellers | Liste as conexões de vendedor da Amazon que este token pode acessar, com seus marketplaces e moedas. |
account_support_access | Conceda ou revogue a visão SOMENTE LEITURA da equipe de suporte da 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: liste 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 as 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 | Waterfall de conta com base em liquidação: receita → reembolsos → COGS → lucro bruto → taxas da 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 mini-cartões de 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, reposição de estoque). |
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 categorias de P&L — verifique se nada está mal classificado ou... |
pnl_summary | Resumo de lucros e perdas para um intervalo de datas: cartões da conta (vendas, taxas, COGS, gastos 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 |
inventory_shipment_tracking | Rastreamento ao vivo da cadeia de suprimentos (SP-API Tracking, somente loja dos EUA): marcos e estimativas para um envio em trânsito pela Amazon — passe UM id... |
product_cogs | Custos landed atuais por SKU (COGS) e resumo de cobertura. |
product_fee_preview | Taxas estimadas pela 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 efetivas de margem BE 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 pesquisa 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 pesquisa: funil de pesquisa orgânica por (ASIN, consulta) — impressões/cliques/adições ao carrinho/compras com participações |
brand_store_analytics | Desempenho da Brand Store (Stores Analytics API): view='insights' = tráfego/vendas da loja por DATA / PÁGINA / FONTE / LOJA / TAG (visitas, visit... |
brand_top_search_terms | Principais termos de pesquisa 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... |
keyword_opportunities | PORTA DE ENTRADA para pesquisa de KW — comece aqui para qualquer pergunta sobre palavras-chave de um produto (novo ou estabelecido) |
keyword_research | Pesquisa de palavras-chave (universo de termos do marketplace): pesquise o armazenamento COMPLETO de Top Search Terms por frase — não ancorado a nenhum ASIN |
PPC — leitura
| Ferramenta | O que faz |
|---|---|
ppc_account_summary | Obtenha métricas agregadas de nível de conta para um intervalo de datas: gasto total, vendas, ACoS, ROAS, cliques, impressões, compras. |
ppc_ad_groups | Consulte dados de desempenho de grupos de anúncios dentro de campanhas |
ppc_ad_type_breakdown | Obtenha comparação de desempenho entre tipos de anúncio (SP vs SB vs SD) |
ppc_advertised_products | Consulte desempenho em nível de produto/ASIN (granularidade de anúncio SP+SD, mesclado por ASIN com divisão por programa; gasto por ASIN em SB existe apenas no blen... |
ppc_asset_upload_link | Gere um link de upload via navegador com validade de 1 hora para que o USUÁRIO possa enviar um arquivo local (anexos de chat não chegam ao servidor) |
ppc_bid_recommendations | Lance sugerido da Amazon + faixa por palavra-chave para uma campanha ESPECÍFICA (roteado por tipo de campanha) |
ppc_budget_alerts | Encontre campanhas se aproximando ou excedendo o orçamento diário — MESMO DIA onde os dados do Marketing Stream fluem (linhas com signal_source=stream são mi... |
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 | Obtenha dados detalhados para campanhas SP específicas, incluindo posicionamentos, ASINs anunciados, modificadores de posicionamento e principais palavras-chave/segmentações |
ppc_campaign_metadata | Configuração da campanha e metadados do usuário: estratégia de lances, configurações de posicionamento, meta/KPI, tags, notas. |
ppc_campaign_search | Consulta leve de nome de campanha |
ppc_campaigns | Consulte dados de desempenho de campanha com filtros opcionais |
ppc_change_history | Obtenha histórico recente de alterações de campanha mostrando o que mudou, quando, valores antigos e novos valores |
ppc_conversion_funnel | Obtenha dados de funil de conversão: Impressões → Cliques → Pedidos com taxas entre cada etapa |
ppc_creatives | Criativos de anúncio SB em granularidade de anúncio (título, logotipo da marca, imagens personalizadas, IDs de ativos de vídeo, ASINs, página de destino, status do criativo) além de criativos SD... |
ppc_daily_trend | Obtenha métricas dia a dia para análise de tendências |
ppc_dayparting_analytics | Agendamento de dayparting E desempenho real por hora do dia |
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 nível de campanha/grupo de anúncios/segmentação/termo de pesquisa/posicionamento... |
ppc_harvesting_candidates | Encontre termos de pesquisa que convertem e são elegíveis para promoção a campanhas manuais |
ppc_keywords | Consulte desempenho de lances de palavras-chave/segmentações em Sponsored Products E Sponsored Brands (linhas carregam ad_type SP/SB; expressões de segmentação SD l... |
ppc_match_type_breakdown | Obtenha detalhamento de desempenho por tipo de correspondência de palavra-chave (Ampla, Frase, Exata, etc.) |
ppc_negation_candidates | Encontre termos de pesquisa sem conversão com gasto significativo — candidatos para adição de palavras-chave negativas |
ppc_negatives | Palavras-chave negativas atuais e segmentações negativas de produto (em nível de campanha e grupo de anúncios), com estado e fonte |
ppc_new_to_brand | Compras/vendas de novos clientes da marca e NTB% por campanha (SB + SD, a partir de colunas padrão de relatório — sem necessidade de AMC) |
ppc_optimization_suggestions | Analise campanhas e categorize em melhor desempenho (no ou abaixo do ACoS alvo), aquecidas (significativamente acima do alvo) e gasto desperdiçado... |
ppc_period_comparison | Compare 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 pesquisa, páginas de produto, restante da pesquisa). |
ppc_placements | Obtenha detalhamento de desempenho por tipo de posicionamento (Topo da Pesquisa, Páginas de Produto, Restante da Pesquisa) a partir de dados de posicionamento SP |
ppc_portfolios | Obtenha resumo de desempenho em nível de portfólio |
ppc_product_family | Consulte a hierarquia de produtos pai/filho na biblioteca de produtos (relatório de listagem de categorias) |
ppc_product_report | O relatório canônico de produto/família — UMA chamada que retorna cada visão rotulada: resolução de família, totais de anúncio precisos por asin (granularidade de anúncio SP+SD —... |
ppc_query | Consulta em 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_recommendations | Recomendações consolidadas da própria Amazon (API unificada de Recomendações): alterações de lance/orçamento/estratégia de lances, novas palavras-chave, negativas, ta... |
ppc_search_terms | Consulte dados de desempenho de termos de pesquisa |
Automação
| Ferramenta | O que faz |
|---|---|
automation_activity | A caixa de entrada de aprovações para automação de regras V2 — a ÚNICA superfície para aprovações de automação pendentes (ferramentas de 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 agendamentos + atribuições (mutações vivem em stage_dayparting_schedule). |
automation_minmax_results | Execuções recentes de análise de orçamento MinMax: escopo, melhores desempenhos, campanhas aquecidas |
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 vivem em stage_automation_rule) |
automation_scheduled_tasks | Tarefas agendadas: tipo, cadência, estado habilitado, horários da última e próxima execução |
Conteúdo A+
| Ferramenta | O que faz |
|---|---|
aplus_document | Busque UM documento de conteúdo A+ AO VIVO, incluindo sua contentModuleList completa — a fonte de cópia para edições (o conjunto de dados aplus_content contém met... |
Gravações em etapas (nada chega à Amazon até você confirmar)
| Ferramenta | O que faz |
|---|---|
cancel_staged_changes | Cancele uma proposta pendente sem executá-la. |
confirm_staged_changes | EXECUTE uma proposta pendente — chame SOMENTE depois de renderizar o diff completo ao usuário como texto (entidades por nome, atual → proposto, r... |
stage_ad_group_create | Crie um novo grupo de anúncios SP em uma campanha existente (nome + lance padrão; criado HABILITADO) |
stage_ad_group_update | Renomeie um grupo de anúncios (SP/SB) ou altere seu lance padrão (somente SP — grupos de anúncios SB não têm lance padrão) |
stage_aplus_update | Crie ou atualize um documento de conteúdo A+ (EBC/Premium), opcionalmente anexe ASINs e envie para aprovação da Amazon |
stage_asset_upload | Envie 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 | Prepare uma decisão sobre itens da caixa de entrada de aprovação de automação (veja automation_activity para a caixa de entrada em si): action=approve|reject|undo, cada ta... |
stage_automation_rule | Prepare uma mutação de regra: action=create|update|delete|toggle|duplicate|assign|unassign|run_now |
stage_bid_changes | Proponha alterações de lance em palavras-chave/segmentações SP + SB + SD que correspondam a filtros (ad_type restringe a um programa) |
stage_budget_changes | Proponha alterações de orçamento diário de campanhas SP |
stage_campaign_create | Crie campanhas Sponsored Products, Sponsored Brands ou Sponsored Display de ponta a ponta |
stage_campaign_tags | Marque/anote uma campanha no AMZ Vault (add_tags / remove_tags / note) — metadados puros, nada é enviado à Amazon |
stage_campaign_update | Atualize campanhas: nome, budget_amount, budget_type (LIFETIME é somente SB), bidding_strategy, start_date / end_date (AAAA-MM-DD; end_d nulo... |
stage_cogs_update | Proponha definir custos de mercadoria (COGS) por SKU, com versão por tempo |
stage_competitor_watchlist | Proponha adicionar/remover ASINs concorrentes na lista de observação de insights de avaliações |
stage_dayparting_schedule | Prepare uma mutação de dayparting: action=create|update|delete|toggle|clone|assign|unassign |
stage_entity_status | Pause/habilite/arquive entidades específicas POR ID: grupos de anúncios, anúncios de produto, palavras-chave, segmentações ou campanhas (complementa o stage baseado em filtro... |
stage_listing_update | Atualize conteúdo AO VIVO de listagem na Amazon: título, bullet_points (lista completa de substituição), descrição, search_terms (palavras-chave de backend, ~249 bytes... |
stage_margin_target | Proponha uma meta manual de margem BE (ponto de equilíbrio) para uma família de produtos (be_margin_pct nulo limpa para que o ponto de equilíbrio calculado se aplique) |
stage_negatives | Proponha adicionar palavras-chave negativas / segmentações negativas de ASIN |
stage_negatives_remove | REMOVA (arquive) palavras-chave negativas / segmentações negativas de produto pelos IDs locais de ppc_negatives — a outra metade do gerenciamento de negações |
stage_po_upsert | Proponha criar ou atualizar ordens de compra (correspondidas por po_number por conexão): nome do fornecedor (criado se novo), status/data de marco... |
stage_portfolio_create | Crie um novo portfólio (sem limite de orçamento; defina orçamentos depois via stage_portfolio_update, incl |
stage_portfolio_update | Atualize um portfólio: nome, budget_amount, budget_policy (DATE_RANGE/MONTHLY_RECURRING/"remove"), budget_start_date, budget_end_date |
stage_product_ad_add | Adicione produtos anunciados a um grupo de anúncios SP ou SD existente (campaign_type, padrão SP) — criado HABILITADO |
stage_product_edit | Proponha editar um campo da Product Library (bloqueia contra sincronizações futuras) |
stage_status_change | Proponha habilitar/pausar campanhas que correspondam a filtros |
stage_supplier_upsert | Proponha criar ou atualizar fornecedores (correspondidos por nome por conexão): contatos, termos de pagamento e os prazos de produção/trânsito t... |
stage_targeting_add | Adicione palavras-chave, segmentações de produto por ASIN e/ou segmentações de categoria a uma campanha + grupo de anúncios EXISTENTE (SP ou SB) — ex. |
staged_changes_pending | Liste as propostas pendentes (não confirmadas) desta conta |
Outros
| Ferramenta | O que faz |
|---|---|
forecast_reorder_report | Reordenador de reabastecimento para uma conexão de vendedor: datas de esgotamento por ASIN a partir da previsão mais recente (contando FBA + AWD + entrada + ordens de compra abertas o... |
forecast_report | A previsão de unidades por ASIN para 12 meses (motor noturno): totais da marca vs ano anterior, índice de sazonalidade, diagnósticos incl |
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 etapas, sempre.
- Não é um raspador. Todos os dados vêm da API oficial Selling Partner da Amazon e da API Amazon Ads 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 vem com cada teste 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 se conectam com suas próprias contas e veem exatamente o que suas permissões de acesso 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 todo o resto.
- A Política de Agentes da Amazon de março de 2026, e como o AMZ Vault está em conformidade com ela: amz-vault.com/blog/amazon-ai-agent-policy
Links
- Site: amz-vault.com
- Demonstração ao vivo (sem cadastro): amz-vault.com/demo
- Documentação de ferramentas: amz-vault.com/docs
- Habilidades gratuitas do Claude construídas neste conector: amz-vault.com/skills
- Suporte: amz-vault.com -> Feedback & Suporte, ou a própria ferramenta
account_feedback