Pixel X App Ir para a Pixel X App
PIXEL X APP • META MARKETING API v25.0

Rastreie, Auditorie e Escale suas Campanhas de Meta Ads com IA.

O MCP (Model Context Protocol) da Pixel X com 163 ferramentas registradas para conectar Claude Code, Cursor, Codex e agentes autônomos ao Facebook, Instagram Ads e WhatsApp Business.

163 Tools 20 Módulos Especializados
100% Seguro OAuth 2.1 e token próprio
0 Setup Pronto para Claude & Cursor
🛡️ Pre-Flight Health Audit
EXCELLENT (100/100)
// Chamada nativa executada pelo agente no MCP
await mcp.audit_campaign_health({
  campaign_id: "1202094857201"
});

// Output de auditoria pré-flight:
{
  "health_score": 100,
  "placements": "Clean (FB/IG active, orphan arrays purged)",
  "cta_status": "SHOP_NOW (BUY_NOW auto-corrected)",
  "spend_limits": "lifetime_min_spend_target resolved (20%)"
}
Por que escolher o Pixel X MCP?

Meta Ads MCP Oficial vs Pixel X Meta Ads MCP

O Pixel X MCP reúne 163 ferramentas registradas em 20 módulos, com automação de campanhas, análise, operações de Pixel / Dataset e gestão de WABAs existentes.

Recurso / Capacidade Meta Ads MCP Oficial (Meta) Pixel X Meta Ads MCP (Nosso)
Total de Ferramentas Nativas ❌ ~15-20 ferramentas básicas ✅ 163 ferramentas (20 módulos)
Edição de Posicionamentos (Placements) ❌ Sobrescreve e corrompe públicos ✅ Endpoint dedicado (Preserva 100% da audiência)
Metas de Gasto Vitalícias (Spend Targets) ❌ Não suportado ✅ Suporta min/max spend target + % em R$
Validação de CTAs de Anúncios ❌ Falha com erro BUY_NOW inválido ✅ Auto-correção automática (BUY_NOW → SHOP_NOW)
Auditoria Pré-Flight de Saúde ❌ Não possui ✅ audit_campaign_health (Health Score 0-100)
Conversions API (CAPI) Server-Side ❌ Não suportado ✅ 14 ferramentas de Pixel / Dataset + send_conversion_event
Criativos em Carrossel Multi-Card ❌ Não suportado ✅ create_carousel_creative nativo
Variações em Lote de Criativos ❌ Criação individual manual ✅ bulk_create_creative_variations (Headlines × Textos × Mídias)
Diagnóstico de Fadiga de Anúncios ❌ Não possui ✅ diagnose_ad_fatigue (Frequência, CTR, CPA)
Regras Automatizadas & Lead Forms ❌ Não possui ✅ Ad Rules, Lead Forms e IG Business Insights
Análise de Sobreposição (Overlap) ❌ Não possui ✅ get_audience_overlap (Previne canibalização)
Ações em Lote com Modo Simulação ❌ Altera direto na API sem prévia ✅ Suporte a dry_run em bulk updates
Inventário de Inteligência

163 Ferramentas MCP Registradas

Estes cards mostram uma seleção por área. O inventário completo e atualizado de 163 ferramentas é disponibilizado pelo MCP via tools/list; as 16 ferramentas de WhatsApp / WABA e as 14 ferramentas de Pixel / Dataset estão listadas individualmente, junto dos 2 resources de Pixel / Dataset.

Anúncios para WhatsApp: selecione um número conectado e use as ferramentas de campanha, conjunto, criativo e anúncio para criar anúncios de imagem ou vídeo que iniciam conversas. A disponibilidade depende das permissões e da elegibilidade dos ativos na Meta.

audit_campaign_health
Campanhas
Auditoria pré-flight com nota de saúde (0-100), Pixel, CBO, CTAs e direcionamentos.
update_ad_set_placements
AdSets
Altera posicionamentos preservando 100% da audiência e limpando posições órfãs.
get_ad_set_placements
AdSets
Lê posicionamentos e plataformas ativas de um conjunto de anúncios.
create_ad_set_enhanced
AdSets
Cria conjuntos com orçamento, público e destino, incluindo um número conectado do WhatsApp.
get_ad_set
AdSets
Lê detalhes completos e targeting integral do ad set.
list_campaigns
Campanhas
Lista campanhas com filtros por status e paginação.
get_campaign
Campanhas
Obtém metadados, objetivo ODAX e orçamentos da campanha.
create_campaign
Campanhas
Cria nova campanha publicitária com suporte a CBO e ODAX.
update_campaign
Campanhas
Atualiza nome, status ou orçamento de uma campanha.
delete_campaign
Campanhas
Exclui ou arquiva uma campanha.
pause_campaign
Campanhas
Pausa a veiculação de uma campanha ativa.
resume_campaign
Campanhas
Retoma a veiculação de uma campanha pausada.
duplicate_campaign
Campanhas
Duplica uma estrutura de campanha existente.
get_campaign_hierarchy
Campanhas
Mapeia toda a hierarquia de ad sets e anúncios vinculados.
validate_campaign_structure
Campanhas
Valida integridade técnica antes do lançamento.
get_campaign_budget_pacing
Campanhas
Monitora o ritmo de consumo de orçamento.
archive_campaign
Campanhas
Arquiva a campanha permanentemente.
list_ad_sets
AdSets
Lista conjuntos de anúncios por campanha.
update_ad_set
AdSets
Atualiza orçamento ou parâmetros do ad set.
delete_ad_set
AdSets
Exclui um conjunto de anúncios.
get_ad_set_readiness
AdSets
Verifica a prontidão técnica do conjunto.
quick_fix_ad_set
AdSets
Aplica correções rápidas em erros comuns.
list_account_ad_sets
AdSets
Lista todos ad sets da conta de anúncios.
list_ads
Ads
Lista os anúncios cadastrados e seus status.
get_ad
Ads
Obtém os detalhes de um anúncio específico.
create_ad
Ads
Cria um novo anúncio associando ad set e criativo.
update_ad
Ads
Atualiza status ou criativo de um anúncio.
create_carousel_creative
Criativos
Cria anúncio em Carrossel multi-card com links e CTAs individuais.
bulk_create_creative_variations
Criativos
Gera variações em lote (Headlines × Textos × Mídias).
create_ad_creative
Criativos
Cria criativos de imagem ou vídeo para links, perfil do Instagram ou conversas no WhatsApp.
list_ad_creatives
Criativos
Lista os criativos da biblioteca da conta.
get_ad_creative
Criativos
Lê especificações técnicas do criativo.
update_ad_creative
Criativos
Atualiza propriedades de um criativo.
delete_ad_creative
Criativos
Exclui um criativo da biblioteca.
create_ab_test_creatives
Criativos
Gera variações para testes A/B de criativos.
upload_ad_image
Mídias
Upload de imagem para os acervos Meta.
upload_ad_video
Mídias
Upload de vídeo para veiculação em anúncios.
get_creative_preview
Criativos
Gera URL de preview do anúncio no FB/IG.
list_ad_images
Mídias
Lista imagens armazenadas na conta.
list_ad_videos
Mídias
Lista vídeos armazenados na conta.
get_creative_breakdown
Criativos
Análise de métricas por elemento do criativo.
validate_creative_assets
Criativos
Valida aspectos, dimensões e formatos.
generate_dynamic_creative
Criativos
Configura anúncios dinâmicos DCO.
duplicate_creative
Criativos
Duplica um criativo existente.
archive_creative
Criativos
Arquiva um criativo sem excluir histórico.
get_creative_fatigue_score
Criativos
Pontuação técnica de desgaste do criativo.
search_ad_library
AdLibrary
Busca anúncios na Biblioteca Pública de Anúncios Meta.
get_ad_library_insights
AdLibrary
Insights de transparência e gastos de concorrentes.
get_audience_overlap
Audiências
Mede a sobreposição entre públicos para evitar auto-bidding.
list_audiences
Audiências
Lista públicos salvos, personalizados e semelhantes.
get_custom_audience
Audiências
Lê propriedades de um público personalizado.
create_custom_audience
Audiências
Escape hatch avançado para regras Custom Audience.
create_customer_list_audience
Audiências
Cria públicos CRM com upload separado e protegido.
create_website_audience
Audiências
Cria públicos de eventos do Pixel.
create_engagement_audience
Audiências
Cria públicos de Page, Instagram, Leads, Shops e AR.
create_video_engagement_audience
Audiências
Cria remarketing por visualização de vídeo.
create_product_audience
Audiências
Cria públicos dinâmicos por eventos de catálogo.
update_custom_audience
Audiências
Atualiza usuários de um público personalizado.
delete_custom_audience
Audiências
Exclui um público personalizado.
create_lookalike_audience
Audiências
Cria público Lookalike (1% a 10%) por país.
estimate_audience_size
Audiências
Estima o alcance potencial de um público.
search_targeting_interests
Targeting
Pesquisa interesses para direcionamento de anúncios.
search_targeting_behaviors
Targeting
Pesquisa comportamentos de compra e uso.
search_targeting_demographics
Targeting
Pesquisa dados demográficos, cargos e educação.
search_geo_locations
Targeting
Busca cidades, estados, países e raios geográficos.
validate_targeting_spec
Targeting
Valida a especificação JSON de direcionamento.
get_reach_estimate
Targeting
Calcula estimativa de alcance com filtros.
suggest_targeting_expansion
Targeting
Sugere expansões inteligentes de público.
get_targeting_insights
Targeting
Insights de afinidade de interesses.
list_catalogs
Catalog
Lista catálogos de produtos e e-commerce.
get_catalog_products
Catalog
Obtém lista de itens de um catálogo DPA.
create_product_set
Catalog
Cria conjuntos de produtos para retargeting dinâmico.
update_catalog_feed
Catalog
Atualiza feed de atualização de catálogo.
list_custom_conversions
Conversions
Lista conversões personalizadas da conta.
get_custom_conversion
Conversions
Lê detalhes de uma conversão personalizada.
create_custom_conversion
Conversions
Cria regra de conversão personalizada por URL/Regra.
delete_custom_conversion
Conversions
Exclui uma conversão personalizada.
diagnose_ad_fatigue
Analytics
Diagnóstico de fadiga por frequência acumulada e CTR.
bulk_pause_low_roas_ads
Analytics
Pausa em lote anúncios abaixo da meta de ROAS (com dry_run).
get_insights
Analytics
Consulta avançada de métricas por nível e período.
compare_performance
Analytics
Comparativo de performance entre dois recortes temporais.
export_insights
Analytics
Exporta relatórios sumarizados para análise por agentes.
get_ad_performance_summary
Analytics
Resumo rápido de ROI, CPA e gasto por anúncio.
get_campaign_insights_breakdown
Analytics
Desdobramentos por dispositivo, gênero e país.
generate_async_report
Reports
Inicia geração assíncrona de relatórios analíticos robustos.
get_report_status
Reports
Verifica status de processamento do relatório.
download_report
Reports
Baixa dados de relatórios concluídos.
schedule_recurring_report
Reports
Agenda relatórios recorrentes.
list_ad_rules
AdRules
Lista regras automatizadas cadastradas no Meta Ads.
get_ad_rule
AdRules
Lê os gatilhos e ações de uma regra automatizada.
create_ad_rule
AdRules
Cria regra automática (ex: pausar se CPA > X).
update_ad_rule
AdRules
Atualiza condições de uma regra existente.
simulate_budget_scaling
Budget
Simulação de impacto financeiro em escala de orçamento (+20%, -10%).
bulk_update_budgets
Budget
Atualização em lote de orçamentos com suporte a dry_run.
get_delivery_estimate
Budget
Estimativa de entregas e alcance por nível de orçamento.
rebalance_budgets
Budget
Redistribuição inteligente de verba entre conjuntos.
copy_campaign
Budget
Copia estrutura de campanha para novo teste.
copy_ad_set
Budget
Copia conjunto de anúncios para outra campanha.
set_budget_schedule
Budget
Agenda horários de pico para orçamento.
get_spend_cap_status
Budget
Monitora limite máximo de gastos da conta.
adjust_bid_strategy
Budget
Ajusta estratégia de lances (Lowest Cost, Bid Cap, Cost Cap).
list_businesses
WhatsApp / WABA
Lista os portfólios empresariais acessíveis para localizar suas WABAs.
list_wabas
WhatsApp / WABA
Lista contas WhatsApp Business próprias ou compartilhadas, com paginação.
get_waba
WhatsApp / WABA
Consulta os dados da WABA e sua situação de revisão e verificação.
list_whatsapp_phone_numbers
WhatsApp / WABA
Lista os números conectados à WABA, seus IDs, nomes verificados e qualidade.
get_whatsapp_phone_number
WhatsApp / WABA
Consulta os dados, a plataforma e a verificação de um número.
validate_whatsapp_ad_setup
WhatsApp / WABA
Verifica acessos e o número selecionado antes de validar o anúncio com a Meta.
get_whatsapp_business_profile
WhatsApp / WABA
Consulta o perfil comercial de um número do WhatsApp.
update_whatsapp_business_profile
WhatsApp / WABA
Atualiza descrição, contato, sites e outros campos do perfil comercial.
list_whatsapp_templates
WhatsApp / WABA
Lista modelos de mensagem e seus estados de aprovação.
get_whatsapp_template
WhatsApp / WABA
Consulta um modelo de mensagem pelo ID.
create_whatsapp_template
WhatsApp / WABA
Envia um modelo de mensagem para revisão da Meta, sem disparar mensagens.
update_whatsapp_template
WhatsApp / WABA
Edita componentes ou categoria de um modelo conforme as regras da Meta.
delete_whatsapp_template
WhatsApp / WABA
Exclui um modelo específico por ID e nome, com confirmação explícita.
list_waba_subscribed_apps
WhatsApp / WABA
Lista os aplicativos inscritos nos eventos da WABA.
subscribe_waba_app
WhatsApp / WABA
Inscreve o aplicativo nos eventos da WABA usando o webhook já configurado.
unsubscribe_waba_app
WhatsApp / WABA
Cancela a inscrição do aplicativo nos eventos da WABA, com confirmação.
create_pixel
Pixels
Cria um Meta Pixel / Dataset em uma conta de anúncios ou Business.
get_pixel
Pixels
Consulta propriedade, configuração, disponibilidade e atividade recente.
list_business_pixels
Pixels
Lista Pixels / Datasets próprios ou acessíveis de um Business.
get_pixel_stats
Pixels
Consulta estatísticas de eventos por período e agregação.
diagnose_pixel
Pixels
Consolida metadados, totais de evento e checks diagnósticos da Meta.
list_pixel_ad_accounts
Pixels
Lista contas de anúncio conectadas ou compartilhadas com o ativo.
share_pixel_with_ad_account
Pixels
Compartilha o ativo com uma conta de anúncios, com prévia dry-run.
unshare_pixel_from_ad_account
Pixels
Remove compartilhamento com confirmação explícita e dry-run.
update_pixel_settings
Pixels
Atualiza nome e automatic matching, com prévia dry-run.
list_pixel_users
Pixels
Lista usuários do Business atribuídos ao Pixel / Dataset.
assign_pixel_user
Pixels
Atribui tarefas de análise, edição, anúncio ou upload a um usuário.
list_pixel_agencies
Pixels
Lista agências com acesso direto ou compartilhado ao ativo.
list_pixels
Pixels
Lista os pixels de rastreamento configurados na conta.
send_conversion_event
Pixels
Envia eventos de conversão server-side via Conversions API (CAPI).
meta://pixels/{pixel_id}/summary
Resource
Resource somente leitura com resumo do Pixel / Dataset.
meta://businesses/{business_id}/pixels
Resource
Resource somente leitura com os Pixels / Datasets próprios de um Business.
list_pages
Pages
Lista páginas do Facebook vinculadas.
get_page_details
Pages
Lê metadados e configurações da página.
list_page_posts
Pages
Lista posts publicados na página.
get_page_post_insights
Pages
Métricas de alcance e engajamento do post.
get_instagram_account
Instagram
Lê detalhes da conta do Instagram Business.
list_instagram_media
Instagram
Lista mídias e posts do perfil do Instagram.
get_instagram_media_insights
Instagram
Métricas de impressões e curtidas da mídia do IG.
get_page_access_token
Pages
Obtém token de acesso da página.
list_lead_forms
Leads
Lista formulários de cadastro (Lead Ads).
get_lead_form_leads
Leads
Extrai cadastros capturados nos formulários.
get_lead_details
Leads
Lê os campos e respostas de um lead específico.
get_ad_account_details
Accounts
Lê dados da conta de anúncios, moeda e fuso horário.
generate_auth_url
OAuth
Gera URL OAuth da Meta, com permissões opcionais de WhatsApp.
exchange_token
OAuth
Troca código por token de acesso.
refresh_token
OAuth
Estende token para longa duração (Long-Lived Token).
validate_token
OAuth
Valida permissões e status do token Meta.
get_token_info
OAuth
Lê metadados da sessão autenticada.
revoke_token
OAuth
Revoga credenciais ativas.
check_system_health
Utility
Verifica a integridade e prontidão do servidor MCP.
get_api_rate_limits
Utility
Monitora limites de chamadas da API Meta Graph.
clear_cache
Utility
Limpa o cache interno de respostas de API.
Casos Práticos com IA

Exemplos de Prompts para Claude, Cursor & Codex

Veja como interagir com seus agentes em linguagem natural aproveitando as ferramentas nativas.

🛡️ Auditoria Pré-Flight
"Audite a campanha 1202094857201 e me dê um relatório de saúde detalhado antes de ativar a veiculação."

O agente chamará audit_campaign_health e retornará os pontos de atenção de Pixel, CBO, CTAs e direcionamentos.

🎯 Edição Segura de Posicionamento
"Altere o ad set 987654 para veicular apenas nos Feeds e Reels do Instagram, preservando 100% da audiência atual."

O agente invocará update_ad_set_placements garantindo que a audiência e o geo permaneçam intactos.

💰 Metas de Gasto e Simulação
"Configure uma meta mínima de gasto vitalício de 20% para o ad set 112233 e simule o impacto de um aumento de 15% no orçamento."

O agente usará resolveSpendTargetCents para definir lifetime_min_spend_target e simulate_budget_scaling para o projecional.

📊 Fadiga de Criativos & Pausa
"Verifique se os anúncios do ad set 445566 estão com fadiga de criativo e me mostre quais têm ROAS menor que 1.2 para pausar."

O agente executará diagnose_ad_fatigue para medir a frequência/CTR e bulk_pause_low_roas_ads em modo dry_run para revisão.

Setup Rápido em 3 Passos

Como conectar ao Claude Code, Cursor ou Codex

Adicione o servidor MCP ao seu cliente preferido em segundos usando o token do Pixel X App.

1. Executar comando via Claude Code

Cole o comando abaixo no seu terminal para adicionar o MCP hospedado Pixel X:

claude mcp add --transport http pixelx-meta https://mcp-meta.pixelx.app/mcp --header "Authorization: Bearer PIXELX_PUBLIC_CLIENT_TOKEN"

1. Adicionar ao claude_desktop_config.json

Adicione este bloco ao seu arquivo de configuração do Claude Desktop:

{
  "mcpServers": {
    "pixelx-meta": {
      "type": "http",
      "url": "https://mcp-meta.pixelx.app/mcp",
      "headers": {
        "Authorization": "Bearer ${PIXELX_MCP_TOKEN}"
      }
    }
  }
}

1. Adicionar via Codex CLI

Execute o comando de instalação no Codex:

codex mcp add pixelx-meta --url https://mcp-meta.pixelx.app/mcp