Get MCP Ads

npx add-mcp 'https://mcp.getmcpads.com/mcp'

Catálogo de ferramentas

388 ferramentas implementadas em 9 fontes documentadas. As notas de acesso às fontes abaixo determinam o que é acionável através de https://mcp.getmcpads.com/mcp.

Ferramentas marcadas como (write) alteram algo na conta ativa. Elas têm pré-visualização por padrão: sem confirm: true a ferramenta descreve a alteração e não aplica nada. Gravações são recusadas por completo no plano Free.

Uma ferramenta só responde por contas que a organização marcou. Qualquer outro identificador é recusado, incluindo contas que a conexão subjacente poderia alcançar de outra forma.

Reddit Ads (50 ferramentas, 19 de gravação)

O acesso de assistente externo está pendente de esclarecimento da Reddit. Operadores autorizados podem gerenciar a conexão de teste; as ferramentas implementadas estão documentadas aqui, mas ainda não são publicamente acionáveis.

• reddit_create_ad (write): criar anúncio Reddit com campos nativos, incluindo objetivos/formados suportados. Pré-visualização por padrão; criações de campanhas/grupos/anúncios estão sempre PAUSADAS. Leia reddit_get_write_schema(operation=ad_create) e a configuração atual antes de editar.
• reddit_create_ad_group (write): criar grupo de anúncios Reddit com campos nativos, incluindo objetivos/formados suportados. Pré-visualização por padrão; criações de campanhas/grupos/anúncios estão sempre PAUSADAS. Leia reddit_get_write_schema(operation=ad_group_create) e a configuração atual antes de editar.
• reddit_create_campaign (write): criar campanha Reddit com campos nativos, incluindo objetivos/formados suportados. Pré-visualização por padrão; criações de campanhas/grupos/anúncios estão sempre PAUSADAS. Leia reddit_get_write_schema(operation=campaign_create) e a configuração atual antes de editar.
• reddit_create_catalog (write): criar catálogo Reddit usando o esquema nativo catalog_create. Pré-visualize primeiro. Importações são assíncronas; consulte os identificadores retornados. Não ativa anúncios.
• reddit_create_custom_audience (write): criar audiência personalizada Reddit com campos nativos, incluindo objetivos/formados suportados. Pré-visualização por padrão; criações de campanhas/grupos/anúncios estão sempre PAUSADAS. Leia reddit_get_write_schema(operation=custom_audience_create) e a configuração atual antes de editar.
• reddit_create_lead_form (write): criar formulário de lead Reddit com campos nativos, incluindo objetivos/formados suportados. Pré-visualização por padrão; criações de campanhas/grupos/anúncios estão sempre PAUSADAS. Leia reddit_get_write_schema(operation=lead_form_create) e a configuração atual antes de editar.
• reddit_create_post (write): criar post Reddit usando o esquema nativo post_create. Pré-visualize primeiro. Importações são assíncronas; consulte os identificadores retornados. Não ativa anúncios.
• reddit_create_product_set (write): criar conjunto de produtos Reddit usando o esquema nativo product_set_create. Pré-visualize primeiro. Importações são assíncronas; consulte os identificadores retornados. Não ativa anúncios.
• reddit_create_saved_audience (write): criar audiência salva Reddit com campos nativos, incluindo objetivos/formados suportados. Pré-visualização por padrão; criações de campanhas/grupos/anúncios estão sempre PAUSADAS. Leia reddit_get_write_schema(operation=saved_audience_create) e a configuração atual antes de editar.
• reddit_get_ad: Ler um anúncio Reddit; verificar se pertence à conta de anúncios selecionada.
• reddit_get_ad_group: Ler um grupo de anúncios Reddit; verificar se pertence à conta de anúncios selecionada.
• reddit_get_ad_groups: Ler grupos de anúncios Reddit, incluindo configuração nativa e status configurado/efetivo. Paginação retorna um cursor opaco; todas as páginas exigem continuação explícita.
• reddit_get_ads: Ler anúncios Reddit, incluindo configuração nativa e status configurado/efetivo. Paginação retorna um cursor opaco; todas as páginas exigem continuação explícita.
• reddit_get_asset_uploads: Consultar o processamento de importações criativas através do perfil selecionado; ACTIVE significa pronto para mídia, não entrega de publicidade.
• reddit_get_campaign: Ler uma campanha Reddit; verificar se pertence à conta de anúncios selecionada.
• reddit_get_campaigns: Ler campanhas Reddit, incluindo configuração nativa e status configurado/efetivo. Paginação retorna um cursor opaco; todas as páginas exigem continuação explícita.
• reddit_get_catalog_imports: Ler catalog_imports de um catálogo Reddit de propriedade da conta.
• reddit_get_catalogs: Ler catálogos de produtos do negócio que possui a conta de anúncios selecionada.
• reddit_get_creative_assets: Listar a biblioteca de ativos do perfil Reddit selecionado; arquivos não utilizados não são necessariamente anúncios.
• reddit_get_custom_audience: Ler uma audiência personalizada Reddit; verificar se pertence à conta de anúncios selecionada.
• reddit_get_custom_audiences: Ler audiências personalizadas Reddit, incluindo configuração nativa e status configurado/efetivo. Paginação retorna um cursor opaco; todas as páginas exigem continuação explícita.
• reddit_get_insights: Relatórios nativos Reddit com métricas e detalhamentos por entidade/audiência, datas UTC explícitas e paginação. Resultados vazios validam apenas o transporte. Demografia de audiência relatada difere do direcionamento configurado.
• reddit_get_lead_form: Ler um formulário de lead Reddit; verificar se pertence à conta de anúncios selecionada.
• reddit_get_lead_gen_forms: Ler formulários de geração de lead Reddit, incluindo configuração nativa e status configurado/efetivo. Paginação retorna um cursor opaco; todas as páginas exigem continuação explícita.
• reddit_get_pixels: Listar pixels acessíveis à conta de anúncios Reddit selecionada.
• reddit_get_post: Ler um post estruturado de anúncio após verificação de propriedade do perfil.
• reddit_get_post_job: Consultar um post estruturado criado anteriormente usando seu recibo de trabalho assinado. Não aceita IDs de trabalho arbitrários de outra conta.
• reddit_get_posts: Listar posts estruturados de publicidade para um perfil vinculado a esta conta. Retorna configuração nativa de imagem/vídeo/carrossel/texto.
• reddit_get_product_sets: Ler product_sets de um catálogo Reddit de propriedade da conta.
• reddit_get_products: Ler produtos de um catálogo Reddit de propriedade da conta.
• reddit_get_profiles: Listar perfis acessíveis à conta de anúncios Reddit selecionada.
• reddit_get_reporting_schema: Inventário de métricas e dimensões Reddit; o direcionamento configurado é lido com reddit_get_targeting, não inferido de relatórios.
• reddit_get_saved_audience: Ler uma audiência salva Reddit; verificar se pertence à conta de anúncios selecionada.
• reddit_get_saved_audiences: Ler audiências salvas Reddit, incluindo configuração nativa e status configurado/efetivo. Paginação retorna um cursor opaco; todas as páginas exigem continuação explícita.
• reddit_get_setup_guide: Cobertura completa do conector Reddit, pré-requisitos e limites de validação ao vivo. Não inferir capacidades indisponíveis da lista inicial curta de ferramentas.
• reddit_get_targeting: Ler direcionamento real do grupo de anúncios: inclusões, exclusões, geo, idade/gênero, idiomas, interesses, comunidades, palavras-chave, dispositivos e IDs de audiência. Isso é configuração, não demografia de entrega.
• reddit_get_targeting_options: Descobrir valores nativos válidos de direcionamento. Comunidades podem ser pesquisadas; listas grandes são paginadas ou explicitamente marcadas como parciais.
• reddit_get_write_schema: Esquemas nativos fixados exatos para criação e edição Reddit, incluindo direcionamento e todos os formatos de campanha/anúncio implementados. Aceitação do provedor é separada da validação local de esquema.
• reddit_health_check: Ler a conta Reddit selecionada, moeda e fuso horário; acesso à API não é prova de entrega ou elegibilidade total de objetivo.
• reddit_list_ad_creatives: Resolver ativos de imagem/vídeo/carrossel vinculados a anúncios com cobertura explícita. Uma capa de vídeo não estabelece seu movimento/áudio; use mídia completa quando disponível.
• reddit_update_ad (write): atualizar anúncio Reddit com campos nativos, incluindo objetivos/formados suportados. Pré-visualização por padrão; criações de campanhas/grupos/anúncios estão sempre PAUSADAS. Leia reddit_get_write_schema(operation=ad_update) e a configuração atual antes de editar.
• reddit_update_ad_group (write): atualizar grupo de anúncios Reddit com campos nativos, incluindo objetivos/formados suportados. Pré-visualização por padrão; criações de campanhas/grupos/anúncios estão sempre PAUSADAS. Leia reddit_get_write_schema(operation=ad_group_update) e a configuração atual antes de editar.
• reddit_update_asset (write): Atualizar campos de ativos Reddit suportados; pré-visualização por padrão. Leia reddit_get_write_schema(operation=asset_update).
• reddit_update_campaign (write): atualizar campanha Reddit com campos nativos, incluindo objetivos/formados suportados. Pré-visualização por padrão; criações de campanhas/grupos/anúncios estão sempre PAUSADAS. Leia reddit_get_write_schema(operation=campaign_update) e a configuração atual antes de editar.
• reddit_update_catalog (write): Atualizar campos de catálogo Reddit suportados; pré-visualização por padrão. Leia reddit_get_write_schema(operation=catalog_update).
• reddit_update_post (write): Atualizar campos de post Reddit suportados; pré-visualização por padrão. Leia reddit_get_write_schema(operation=post_update).
• reddit_update_product_set (write): Atualizar campos de conjunto de produtos Reddit suportados; pré-visualização por padrão. Leia reddit_get_write_schema(operation=product_set_update).
• reddit_update_saved_audience (write): atualizar audiência salva Reddit com campos nativos, incluindo objetivos/formados suportados. Pré-visualização por padrão; criações de campanhas/grupos/anúncios estão sempre PAUSADAS. Leia reddit_get_write_schema(operation=saved_audience_update) e a configuração atual antes de editar.
• reddit_upload_creative_assets (write): enviar ativos criativos Reddit usando o esquema nativo asset_upload. Pré-visualize primeiro. Importações são assíncronas; consulte os identificadores retornados. Não ativa anúncios.
• reddit_upsert_products (write): inserir ou atualizar produtos Reddit usando o esquema nativo products_upsert. Pré-visualize primeiro. Importações são assíncronas; consulte os identificadores retornados. Não ativa anúncios.

Microsoft Advertising (39 ferramentas, 20 de gravação)

O acesso de assistente externo não está habilitado. Testes em sandbox e descoberta de contas de produção estão disponíveis para operadores autorizados. A verificação de consentimento do editor e de locatários externos continua em andamento; o token de desenvolvedor já foi obtido.

• bing_add_ad_group_targeting (write): Adiciona um critério de segmentação nativo de grupo de anúncios. Leia a segmentação atual antes de editar; use Targets para edições demográficas/geográficas e Audience para associações de público. Não limpa critérios não especificados.
• bing_add_campaign_targeting (write): Adiciona um critério de segmentação nativo de campanha. Leia a segmentação atual antes de editar; use Targets para edições demográficas/geográficas e Audience para associações de público. Não limpa critérios não especificados.
• bing_create_ad (write): Cria um anúncio do Microsoft Ads com campos nativos. Visualização por padrão. Entidades de anúncio são criadas em Pausado. Leia bing_get_write_schema e a configuração atual primeiro.
• bing_create_ad_group (write): Cria um grupo de anúncios do Microsoft Ads com campos nativos. Visualização por padrão. Entidades de anúncio são criadas em Pausado. Leia bing_get_write_schema e a configuração atual primeiro.
• bing_create_asset_group (write): Cria um grupo de ativos do Performance Max pausado com ativos de texto/imagem. Requer uma campanha elegível e todos os ativos obrigatórios; a visualização local não é validação do provedor.
• bing_create_audience (write): Cria um público do Microsoft Ads com campos nativos. Visualização por padrão. Entidades de anúncio são criadas em Pausado. Leia bing_get_write_schema e a configuração atual primeiro.
• bing_create_campaign (write): Cria uma campanha do Microsoft Ads com campos nativos. Visualização por padrão. Entidades de anúncio são criadas em Pausado. Leia bing_get_write_schema e a configuração atual primeiro.
• bing_create_conversion_goal (write): Cria uma configuração de conversion_goal do Microsoft Ads. Sem instalação no site ou injeção de eventos. Visualize primeiro; metas de conversão são criadas pausadas e excluídas do leilão.
• bing_create_keyword (write): Cria uma palavra-chave do Microsoft Ads com campos nativos. Visualização por padrão. Entidades de anúncio são criadas em Pausado. Leia bing_get_write_schema e a configuração atual primeiro.
• bing_create_uet_tag (write): Cria uma configuração de uet_tag do Microsoft Ads. Sem instalação no site ou injeção de eventos. Visualize primeiro; metas de conversão são criadas pausadas e excluídas do leilão.
• bing_get_ad_groups: Lê grupos de anúncios e configuração nativa em uma campanha de propriedade da conta.
• bing_get_ads: Lê anúncios, incluindo ativos criativos nativos, URLs e status. AdTypes controla explicitamente os formatos retornados.
• bing_get_asset_groups: Lê grupos de ativos do Performance Max com configuração criativa nativa e status.
• bing_get_audiences: Lê a configuração de público acessível para um tipo explícito. Um público vazio não estabelece capacidade de correspondência ou segmentação.
• bing_get_campaigns: Lê configuração nativa de campanha, orçamento, configurações e status para um tipo de campanha explícito. Repita para outros tipos para inventariar toda a conta.
• bing_get_conversion_goals: Lê a configuração de metas de conversão; isso não estabelece que os eventos estão fluindo.
• bing_get_geo_file: Obtém o link de download atual do catálogo de segmentação geográfica da Microsoft. Use os Location IDs ativos; nunca reutilize IDs de localização do Google.
• bing_get_insights: Envia um relatório assíncrono do Microsoft Ads para a conta selecionada. Consulte o recibo assinado com bing_get_report. A compatibilidade de colunas nativas e a disponibilidade de dados no sandbox se aplicam.
• bing_get_keywords: Lê palavras-chave, tipos de correspondência, lances e status de um grupo de anúncios de propriedade da conta.
• bing_get_media: Lê metadados de mídia do Microsoft Ads enviada por ID na conta selecionada.
• bing_get_report: Consulta e baixa um relatório do Microsoft Ads vinculado a esta conta e ambiente selecionados. Retorna até 2.000 linhas CSV; reduza o intervalo se truncado. Saída vazia do sandbox não é evidência de desempenho em produção.
• bing_get_reporting_schema: Lê os tipos de relatório fixados da Microsoft, colunas nativas suportadas e referências oficiais. Selecione colunas para um tipo de relatório compatível; uma entrada de catálogo não é evidência de dados populados ou de produção.
• bing_get_setup_guide: Cobertura do conector do Microsoft Ads, validação no sandbox e limitações restantes. Leia antes de reivindicar paridade ou recursos não suportados.
• bing_get_targeting: Lê a segmentação real configurada de campanha ou grupo, separadamente por tipo de critério. Inclui objetos de critério de inclusão/exclusão; isso é configuração, não desempenho demográfico.
• bing_get_uet_tags: Lê a configuração da tag de rastreamento UET. Nenhum código de rastreamento de site é instalado por esta operação.
• bing_get_videos: Lê ativos de vídeo da conta e status de processamento. Ativo significa que a mídia está pronta, não que um anúncio está em veiculação. O acesso a vídeos depende da elegibilidade da conta; use os códigos de falha retornados.
• bing_get_write_schema: Campos de entidade nativa fixados da Microsoft. Leia a documentação de cada objeto polimórfico para seu valor de REST Type. Os esquemas descrevem a API; a elegibilidade da conta permanece separada.
• bing_health_check: Lê a conta selecionada e confirma sandbox/produção, cliente e moeda. Isso não valida todos os recursos.
• bing_import_video (write): Importa um vídeo do seu arquivo HTTPS diretamente baixável para a conta selecionada. A Microsoft busca e transcodifica a fonte de forma assíncrona; um ID retornado não é prontidão. Visualize primeiro e depois consulte bing_get_videos. Não cria nem ativa um anúncio.
• bing_list_ad_creatives: Recupera representações reais de imagens vinculadas a anúncios de propriedade da conta e grupos de ativos do Performance Max, preservando IDs/nomes pais. Inventário limitado; sem inferência de veiculação, conteúdo de vídeo ou atribuição de KPI.
• bing_update_ad (write): Atualiza um anúncio do Microsoft Ads com campos nativos. Visualização por padrão. Entidades de anúncio são criadas em Pausado. Leia bing_get_write_schema e a configuração atual primeiro.
• bing_update_ad_group (write): Atualiza um grupo de anúncios do Microsoft Ads com campos nativos. Visualização por padrão. Entidades de anúncio são criadas em Pausado. Leia bing_get_write_schema e a configuração atual primeiro.
• bing_update_ad_group_targeting (write): Atualiza um critério de segmentação nativo de grupo de anúncios. Leia a segmentação atual antes de editar; use Targets para edições demográficas/geográficas e Audience para associações de público. Não limpa critérios não especificados.
• bing_update_audience (write): Atualiza um público do Microsoft Ads com campos nativos. Visualização por padrão. Entidades de anúncio são criadas em Pausado. Leia bing_get_write_schema e a configuração atual primeiro.
• bing_update_campaign (write): Atualiza uma campanha do Microsoft Ads com campos nativos. Visualização por padrão. Entidades de anúncio são criadas em Pausado. Leia bing_get_write_schema e a configuração atual primeiro.
• bing_update_campaign_targeting (write): Atualiza um critério de segmentação nativo de campanha. Leia a segmentação atual antes de editar; use Targets para edições demográficas/geográficas e Audience para associações de público. Não limpa critérios não especificados.
• bing_update_keyword (write): Atualiza uma palavra-chave do Microsoft Ads com campos nativos. Visualização por padrão. Entidades de anúncio são criadas em Pausado. Leia bing_get_write_schema e a configuração atual primeiro.
• bing_update_video (write): Atualiza a descrição de um ativo de vídeo de propriedade da conta. Não altera a veiculação nem substitui a fonte do vídeo. Visualização por padrão; leitura de volta com bing_get_videos.
• bing_upload_image (write): Envia bytes de imagem para a biblioteca do Microsoft Ads selecionada. Não cria nem ativa um anúncio. A visualização local relata o comprimento em bytes sem repetir o corpo da imagem.

Snapchat Ads (41 ferramentas, 21 de escrita)

Disponível para contas autorizadas e selecionadas.

• snapchat_create_ad (write): Crie um anúncio do Snapchat. Sempre PAUSADO. Visualização local por padrão; confirme gravações reais após verificar a propriedade da conta/entidade pai.
• snapchat_create_adsquad (write): Crie um adsquad do Snapchat. Sempre PAUSADO. Visualização local por padrão; confirme gravações reais após verificar a propriedade da conta/entidade pai.
• snapchat_create_campaign (write): Crie uma campanha do Snapchat. Sempre PAUSADO. Visualização local por padrão; confirme gravações reais após verificar a propriedade da conta/entidade pai.
• snapchat_create_creative (write): Crie um criativo do Snapchat. Visualização local por padrão; confirme gravações reais após verificar a propriedade da conta/entidade pai.
• snapchat_create_creative_element (write): Crie um creative_element do Snapchat. Visualização local por padrão; confirme gravações reais após verificar a propriedade da conta/entidade pai.
• snapchat_create_interaction_zone (write): Crie uma interaction_zone do Snapchat. Visualização local por padrão; confirme gravações reais após verificar a propriedade da conta/entidade pai.
• snapchat_create_lead_generation_form (write): Crie um lead_generation_form do Snapchat. Visualização local por padrão; confirme gravações reais após verificar a propriedade da conta/entidade pai.
• snapchat_create_lookalike (write): Crie uma audiência semelhante (lookalike) a partir de uma lista de clientes própria como semente. Elegibilidade do provedor e tamanho suficiente da semente ainda se aplicam; a criação não garante targetable_status READY. Visualize a menos que confirme true.
• snapchat_create_media (write): Crie uma mídia do Snapchat. Visualização local por padrão; confirme gravações reais após verificar a propriedade da conta/entidade pai.
• snapchat_create_segment (write): Crie um segmento do Snapchat. Visualização local por padrão; confirme gravações reais após verificar a propriedade da conta/entidade pai.
• snapchat_finalize_media_upload (write): Finalize um upload de vídeo após todas as partes terem sido bem-sucedidas. Use o finalize_path e o upload_id exatos retornados por init_media_upload. Visualize a menos que confirme true.
• snapchat_get_ads: Liste anúncios do Snapchat na conta selecionada, mantendo a configuração nativa completa e a paginação. Um adsquad é um grupo de anúncios/conjunto de anúncios.
• snapchat_get_adsquads: Liste adsquads do Snapchat na conta selecionada, mantendo a configuração nativa completa e a paginação. Um adsquad é um grupo de anúncios/conjunto de anúncios.
• snapchat_get_campaigns: Liste campanhas do Snapchat na conta selecionada, mantendo a configuração nativa completa e a paginação. Um adsquad é um grupo de anúncios/conjunto de anúncios.
• snapchat_get_creative_elements: Liste creative_elements do Snapchat na conta selecionada, mantendo a configuração nativa completa e a paginação. Um adsquad é um grupo de anúncios/conjunto de anúncios.
• snapchat_get_creatives: Liste criativos do Snapchat na conta selecionada, mantendo a configuração nativa completa e a paginação. Um adsquad é um grupo de anúncios/conjunto de anúncios.
• snapchat_get_entity: Leia uma campanha, adsquad, anúncio, criativo, mídia ou segmento com propriedade de conta verificada.
• snapchat_get_insights: Leia estatísticas nativas do Snapchat com intervalo de tempo explícito (final exclusivo), granularidade e detalhamento opcional por entidade. Gastos e valores de conversão monetária estão em micro moeda. Resultados vazios de contas de teste não são evidência de desempenho real.
• snapchat_get_interaction_zones: Liste interaction_zones do Snapchat na conta selecionada, mantendo a configuração nativa completa e a paginação. Um adsquad é um grupo de anúncios/conjunto de anúncios.
• snapchat_get_lead_generation_forms: Liste lead_generation_forms do Snapchat na conta selecionada, mantendo a configuração nativa completa e a paginação. Um adsquad é um grupo de anúncios/conjunto de anúncios.
• snapchat_get_media: Liste mídias do Snapchat na conta selecionada, mantendo a configuração nativa completa e a paginação. Um adsquad é um grupo de anúncios/conjunto de anúncios.
• snapchat_get_mobile_apps: Leia os Snap App IDs associados à conta de anúncios selecionada antes de criar campanhas de promoção de aplicativos ou audiências de retargeting móvel.
• snapchat_get_pixels: Leia os pixels associados à conta selecionada antes de configurar otimização de conversão ou audiências de site.
• snapchat_get_segments: Liste segmentos do Snapchat na conta selecionada, mantendo a configuração nativa completa e a paginação. Um adsquad é um grupo de anúncios/conjunto de anúncios.
• snapchat_get_setup_guide: Leia os objetivos de campanha do Snapchat, fluxos de trabalho de audiência, pré-requisitos de formato de criativo e limitações explícitas. A implementação não é prova de elegibilidade da conta ou entrega ao vivo. Use antes de afirmar que todos os recursos estão disponíveis.
• snapchat_get_targeting: Leia a segmentação configurada do adsquad, audiências, exclusões, dados demográficos, geolocalização e posicionamentos. Campos ausentes são desconhecidos, não prova de segmentação ampla. Detalhamentos de desempenho descrevem entrega, não segmentação configurada.
• snapchat_get_targeting_options: Descubra valores de segmentação nativos antes de editar: países, regiões, idiomas, gêneros, interesses e dispositivos. Mantém a paginação; não invente IDs de categorias.
• snapchat_get_targeting_specs: Leia especificações de segmentação armazenadas separadamente, incluindo configurações que excedem 500 critérios. Elas podem ser omitidas da resposta comum de adsquad.
• snapchat_get_write_schema: Descubra campos de criação/edição do Snapchat implementados, campos obrigatórios e regras de visualização. Estes são campos suportados pelo conector, não um esquema exaustivo da Snap API.
• snapchat_health_check: Leia a conta do Snapchat selecionada, metadados visíveis por permissões e flag de teste. Contas de teste não podem veicular anúncios.
• snapchat_init_media_upload (write): Inicialize um upload de vídeo em partes, até 256 MiB em no máximo 32 partes de 8 MiB. Retorna upload_id, add_path e finalize_path para uso em chamadas subsequentes. Visualize a menos que confirme true.
• snapchat_list_ad_creatives: Resolva imagens/vídeos do Snapchat vinculados a anúncios, filhos de Story e tiles de Collection com nomes de negócios, IDs nativos e URLs de mídia atualizadas. Formatos/mídias incompletos são relatados. Nenhum desempenho é inferido.
• snapchat_update_ad (write): Atualize a configuração do anúncio do Snapchat, incluindo o nome. Visualização por padrão; propriedade verificada antes de aplicar.
• snapchat_update_adsquad (write): Atualize a configuração do adsquad do Snapchat, incluindo nome, segmentação, agendamento e orçamento. Visualização por padrão; propriedade verificada antes de aplicar.
• snapchat_update_audience_users (write): Adicione ou remova membros da lista de clientes. Aceita apenas hashes SHA-256 normalizados: EMAIL_SHA256, PHONE_SHA256, MOBILE_AD_ID_SHA256. Normalize e-mails removendo espaços e convertendo para minúsculas; telefones para dígitos com código do país; IDs móveis em minúsculas mantendo hífens. Nunca invente dados de clientes. A visualização retorna contagens, não hashes. O chamador envia em lotes de até 10.000 por solicitação; confirm true aplica.
• snapchat_update_campaign (write): Atualize a configuração da campanha do Snapchat, incluindo o nome. Visualização por padrão; propriedade verificada antes de aplicar.
• snapchat_update_creative (write): Atualize a configuração do criativo do Snapchat, incluindo o nome. Visualização por padrão; propriedade verificada antes de aplicar.
• snapchat_update_segment (write): Renomeie ou edite retenção/descrição de um segmento de audiência. Campos inalterados são preservados. Visualização local a menos que confirme true.
• snapchat_update_status (write): Pause ou ative uma campanha, adsquad ou anúncio. Visualização por padrão; ativar entidades de produção pode gastar orçamento.
• snapchat_upload_media (write): Envie bytes de imagem/vídeo em base64 para um objeto de mídia criado anteriormente. Máximo de 10 MiB decodificados. Sem busca de URL externa. A visualização não envia bytes; confirm true envia após verificação de propriedade.
• snapchat_upload_media_part (write): Envie uma parte de vídeo, no máximo 8 MiB decodificados. Use o add_path e o upload_id exatos retornados por init_media_upload. A visualização nunca envia bytes.

Meta Ads (57 ferramentas, 23 de escrita)

Disponível para contas autorizadas e selecionadas.

• meta_batch_catalog_items (write): Cria ou atualiza até 50 produtos de catálogo por retailer_id. Retorna identificadores de lote assíncronos; a aceitação não significa conclusão. Sem exclusão ou upsert automático. Pré-visualização local por padrão. Sem nova tentativa automática. A propriedade da conta é verificada antes da validação ou mutação no Meta.
• meta_create_ad (write): Cria um anúncio PAUSADO usando um conjunto de anúncios e uma peça criativa existentes da conta selecionada. Pré-visualização local por padrão. Sem nova tentativa automática. A propriedade da conta é verificada antes da validação ou mutação no Meta.
• meta_create_adcreative (write): Cria uma peça criativa de anúncio a partir de uma publicação existente ou de um object_story_spec explícito e um asset_feed_spec opcional. Suporta especificações de imagem, vídeo, carrossel, coleção e flexíveis. Não lança um anúncio. Pré-visualização local por padrão. Sem nova tentativa automática. A propriedade da conta é verificada antes da validação ou mutação no Meta.
• meta_create_adset (write): Cria um conjunto de anúncios PAUSADO no Meta com segmentação, otimização, posicionamentos, atribuição, lances e programação explícitos. Os valores usam as unidades principais da moeda da conta. Pré-visualização local por padrão. Sem nova tentativa automática. A propriedade da conta é verificada antes da validação ou mutação no Meta.
• meta_create_campaign (write): Cria uma campanha no Meta. Ela é sempre criada PAUSADA e não há opção de criá-la ativa. Pré-visualizações por padrão.
• meta_create_custom_audience (write): Cria um público de site, engajamento, contêiner de lista de clientes ou público semelhante. Não faz upload de dados de clientes. Termos e elegibilidade são aplicados pelo Meta. Pré-visualização local por padrão. Sem nova tentativa automática. A propriedade da conta é verificada antes da validação ou mutação no Meta.
• meta_create_product_set (write): Cria um conjunto de produtos filtrado em um catálogo de propriedade do mesmo Business que a conta de anúncios selecionada. Nunca publica no Shops. Pré-visualização local por padrão. Sem nova tentativa automática. A propriedade da conta é verificada antes da validação ou mutação no Meta.
• meta_debug_token: Verifica a validade, a expiração e os escopos concedidos do token de acesso atual. Útil para diagnosticar problemas de autenticação.
• meta_duplicate_adset (write): Duplica um conjunto de anúncios conhecido como bom dentro da conta selecionada, preservando a configuração nativa complexa. Sempre PAUSADO e SEM copiar anúncios. Renomeie-o depois com meta_rename_adset. Pré-visualização local por padrão. Sem nova tentativa automática. A propriedade da conta é verificada antes da validação ou mutação no Meta.
• meta_get_account_details: Obtém informações detalhadas de uma conta de anúncios específica do Meta: nome, moeda, fuso horário, limite de gastos, status e informações do negócio.
• meta_get_ad_activity: Lê os registros de atividade da conta de anúncios de /{ad_account_id}/activities com campos de objeto, evento, ator, carimbo de data/hora e extra_data.
• meta_get_ad_studies: Lista estudos de lift de conversão e testes A/B (Ad Studies) para uma conta de anúncios. Inclui tipo de estudo, status e células.
• meta_get_ads: Lista anúncios de uma conta de anúncios do Meta, opcionalmente filtrados por conjunto de anúncios. Retorna ID do anúncio, nome, status e referência da peça criativa.
• meta_get_adset_configuration: Lê um conjunto de anúncios existente, o orçamento/objetivo da campanha pai e a moeda da conta antes de preparar uma edição. Retorna configurações nativas; sem mutação.
• meta_get_adsets: Lista conjuntos de anúncios de uma conta de anúncios do Meta, opcionalmente filtrados por campanha. Retorna informações de segmentação, orçamento, otimização e programação.
• meta_get_audience_details: Lê públicos personalizados, salvos e semelhantes detalhados com paginação e campos ricos onde as permissões permitirem.
• meta_get_audiences: Lista públicos personalizados, salvos e semelhantes de uma conta de anúncios do Meta.
• meta_get_brand_safety_controls: Lê sinais de segurança da marca, adequação, posicionamento e controle de contexto da segmentação da conta de anúncios/conjunto de anúncios e bordas opcionais de lista de bloqueio.
• meta_get_business_assets: Descobre ativos de negócios acessíveis do Meta somente leitura: negócios, páginas, contas do Instagram, pixels e conjuntos de dados quando as permissões permitirem.
• meta_get_campaign_structure: Obtém a estrutura hierárquica da campanha: campanhas -> conjuntos de anúncios -> anúncios. Útil para entender a organização da conta.
• meta_get_campaigns: Lista campanhas de uma conta de anúncios do Meta. Retorna ID da campanha, nome, status, objetivo, orçamento e estratégia de lance.
• meta_get_catalog_batch_status: Lê a conclusão e os erros por item de um identificador de lote de catálogo. A aceitação de um lote não é prova de que todos os produtos foram bem-sucedidos.
• meta_get_catalog_products: Lê Catálogos de Produtos e Itens de Produto quando o acesso ao catálogo está disponível. Retorna metadados de produto prontos para junção sem criar ou atualizar ativos de catálogo.
• meta_get_creative_assets: Retorna mídia criativa vinculada a anúncios com nomes reais de anúncios, capas de coleção, todos os componentes de carrossel/flexíveis, hashes de imagem resolvidos e URLs de vídeo. Anúncios somente de catálogo são classificados separadamente; use get_creative_gallery para uma galeria visual. Metadados criativos brutos permanecem disponíveis para diagnóstico.
• meta_get_creatives: Obtém o conteúdo criativo do anúncio: texto, imagens, vídeos, links, chamada para ação. Retorna detalhes criativos para anúncios especificados.
• meta_get_delivery_diagnostics: Agrega diagnósticos de entrega somente leitura em campanhas, conjuntos de anúncios e anúncios usando status/effective_status/issues_info quando disponíveis, além de insights simples de entrega.
• meta_get_insights: Consulta insights de desempenho de anúncios do Meta. Suporta mais de 170 métricas e mais de 43 agrupamentos com planejamento inteligente de consultas. Use o recurso meta://metrics para ver as métricas disponíveis. Use meta://breakdowns para os agrupamentos disponíveis. O planejador de consultas divide automaticamente combinações incompatíveis de métrica/agrupamento em várias solicitações de API e mescla os resultados.
• meta_get_instagram_accounts: Lista contas do Instagram vinculadas a Páginas acessíveis, ativos do Business Manager ou uma conta de anúncios quando as permissões permitirem.
• meta_get_organic_content_enrichment: Lê publicações de Páginas do Facebook e mídia do Instagram com URLs, períodos nativos e insights opcionais. São insights de conteúdo, não Insights de Anúncios; não infira um agrupamento somente orgânico.
• meta_get_page_posts: Lê publicações publicadas de Páginas do Facebook usando um token de Página resolvido do usuário conectado. Retorna PageID_PostID exato, mensagem, link permanente e anexos de mídia. Use postId para uma pré-verificação exata de anúncio de publicação existente. Nenhuma mídia, comentário, curtida ou insight do Instagram é solicitada; esta leitura sozinha não estabelece elegibilidade para publicidade.
• meta_get_pages: Lista Páginas do Facebook acessíveis com id, nome, categoria, tarefas, imagem e referências de conta do Instagram vinculada quando disponíveis.
• meta_get_pixels: Lista pixels e conjuntos de dados de uma conta de anúncios ou Business Manager quando acessíveis, retornando avisos acionáveis para bordas com permissão limitada.
• meta_get_study_results: Obtém resultados detalhados de um estudo de lift de conversão ou teste A/B. Retorna objetivos, células e resultados de lift.
• meta_get_video_sources: Resolve URLs de download atualizadas (source) e miniaturas para vídeos de anúncios específicos. Chame isso no momento do download: as URLs retornadas são assinadas e expiram rapidamente.
• meta_health_check: Verificação de saúde somente leitura pronta para agente: valida metadados do token, lista contas de anúncios acessíveis e avisa sobre escopos de leitura ausentes sem expor o token de acesso.
• meta_interpret_experiment_results: Lê e interpreta resultados de testes A/B ou estudos de lift de conversão com proteções de confiança, células, objetivos e entidades de célula opcionais.
• meta_join_product_insights: Consulta insights com agrupamento por produto e enriquece linhas com metadados do Catálogo de Produtos quando o acesso ao catálogo está disponível.
• meta_list_ad_accounts: Lista todas as contas de anúncios do Meta acessíveis com o token atual. Retorna ID da conta, nome, moeda, fuso horário e status.
• meta_list_ad_images: Lista a biblioteca de imagens da conta de anúncios (/adimages): hash, nome, dimensões, status, uma URL de exibição pública permanente (permalink_url), URLs de CDN de curta duração e, opcionalmente, as peças criativas que usam cada imagem.
• meta_list_ad_videos: Lista a biblioteca de vídeos da conta de anúncios (/advideos): título, duração, status de processamento e miniaturas servidas publicamente (tamanhos preferido e maior). URLs de arquivos de origem são retornadas somente sob solicitação porque expiram rapidamente.
• meta_rename_ad (write): Renomeia um anúncio do Meta. O nome é a única coisa que muda. Pré-visualizações por padrão.
• meta_rename_adset (write): Renomeia um conjunto de anúncios do Meta. O nome é a única coisa que muda. Pré-visualizações por padrão.
• meta_rename_campaign (write): Renomeia uma campanha do Meta. O nome é a única coisa que muda. Pré-visualizações por padrão.
• meta_search_entities: Pesquisa campanhas, conjuntos de anúncios ou anúncios por nome dentro de uma conta de anúncios. Útil para encontrar entidades específicas.
• meta_update_ad_creative (write): Substitui a peça criativa de um anúncio por outra peça criativa existente da mesma conta. O status do anúncio permanece inalterado. Pré-visualização local por padrão. Sem nova tentativa automática. A propriedade da conta é verificada antes da validação ou mutação no Meta.
• meta_update_ad_status (write): Pausa ou reativa um anúncio do Meta. Pré-visualizações por padrão: sem confirm: true, a ferramenta descreve a alteração sem aplicá-la.
• meta_update_adset_budget (write): Altera o orçamento diário ou vitalício de um conjunto de anúncios do Meta. Valor na moeda da conta (12.50 para 12.50 EUR). O Meta espera unidades menores; a conversão é feita aqui. Pré-visualizações por padrão.
• meta_update_adset_configuration (write): Atualiza segmentação, otimização, posicionamentos, atribuição, lances, orçamento ou programação. A segmentação é uma SUBSTITUIÇÃO COMPLETA, não uma mesclagem parcial. O status permanece inalterado. Pré-visualização local por padrão. Sem nova tentativa automática. A propriedade da conta é verificada antes da validação ou mutação no Meta.
• meta_update_adset_schedule (write): Altera o horário de início ou término de um conjunto de anúncios do Meta. Os horários estão em ISO 8601 com offset, por exemplo 2026-09-01T00:00:00+0200. Pré-visualizações por padrão.
• meta_update_adset_status (write): Pausa ou reativa um conjunto de anúncios do Meta. Pré-visualizações por padrão: sem confirm: true, a ferramenta descreve a alteração sem aplicá-la.
• meta_update_campaign_budget (write): Altera o orçamento de uma campanha do Meta que mantém seu orçamento no nível da campanha (orçamento de campanha Advantage). Em uma campanha sem isso, o Meta recusa e o orçamento do conjunto de anúncios é o que deve ser alterado. Valor na moeda da conta. Pré-visualizações por padrão.
• meta_update_campaign_status (write): Pausa ou reativa uma campanha do Meta. Pré-visualizações por padrão: sem confirm: true, a ferramenta descreve a alteração sem aplicá-la.
• meta_update_custom_audience (write): Atualiza o nome, a descrição, a retenção ou a regra completa de um público personalizado existente. Não altera a associação ao público diretamente. Pré-visualização local por padrão. Sem nova tentativa automática. A propriedade da conta é verificada antes da validação ou mutação no Meta.
• meta_update_product_set (write): Substitui o filtro de um conjunto de produtos ou o renomeia. A propriedade do catálogo e a associação ao conjunto são verificadas antes da escrita. Pré-visualização local por padrão. Sem nova tentativa automática. A propriedade da conta é verificada antes da validação ou mutação no Meta.
• meta_upload_ad_image (write): Faz upload de uma imagem na conta de anúncios selecionada usando bytes base64 (até 5 MiB decodificados). A pré-visualização relata apenas o tamanho, nunca o corpo do arquivo. Pré-visualização local por padrão. Sem nova tentativa automática. A propriedade da conta é verificada antes da validação ou mutação no Meta.
• meta_upload_ad_video (write): Importa um vídeo de uma URL HTTPS publicamente acessível ou bytes MP4 base64 (até 5 MiB decodificados). O Meta o processa de forma assíncrona. Nenhuma campanha é lançada. Pré-visualização local por padrão. Sem nova tentativa automática. A propriedade da conta é verificada antes da validação ou mutação no Meta.
• meta_validate_query: Valida uma combinação de métrica/agrupamento ANTES de executar. Retorna erros e avisos. Use isso para verificar se sua consulta funcionará.

Pinterest Ads (52 ferramentas, 24 de escrita)

Disponível para contas autorizadas e selecionadas.

• pinterest_batch_catalog_items (write): Enviar operações nativas de CREATE/UPDATE/UPSERT/DELETE de itens de catálogo. Consulte o ID do lote retornado antes de reportar a conclusão. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_create_ad (write): Criar um anúncio PAUSADO a partir de um Pin acessível. A especificação nativa suporta formatos criativos do Pinterest sujeitos à elegibilidade. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_create_adgroup (write): Criar um grupo de anúncios PAUSADO com lances, segmentação, orçamento e agendamento nativos explícitos. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_create_board (write): Criar /boards no contexto do anunciante selecionado. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_create_campaign (write): Criar uma campanha PAUSADA. Campos monetários de conveniência usam a moeda da conta. A Otimização de Orçamento de Campanha (CBO) é definida como verdadeira por padrão; elegibilidade não-CBO é específica da conta. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_create_catalog (write): Criar /catalogs no contexto do anunciante selecionado. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_create_catalog_feed (write): Criar /catalogs/feeds no contexto do anunciante selecionado. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_create_pin (write): Criar /pins no contexto do anunciante selecionado. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_create_product_group (write): Criar /catalogs/product_groups no contexto do anunciante selecionado. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_create_product_group_promotion (write): Criar uma promoção PAUSADA de shopping ou coleções a partir de um grupo de produtos de catálogo. Indisponível no Sandbox. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_estimate_delivery: Executar cálculos de planejamento do Pinterest sem mutação: tamanho do público do grupo de anúncios, pisos de lance ou estimativas de entrega da campanha. O corpo da solicitação segue o esquema selecionado do Pinterest v5 e nenhuma campanha ou grupo de anúncios é criado ou alterado.
• pinterest_get_account_entities: Ler entidades e configuração da conta de anúncios do Pinterest. Abrange conta, campanha, grupo de anúncios, anúncio, promoção de grupo de produtos, promoção, rótulo, agendamento, modelo de segmentação e inventário de linhas de pedido. Retorna uma página da API e seu marcador para consultas ao vivo previsíveis.
• pinterest_get_audience_insights: Ler insights agregados de público do Pinterest para o público total ou engajado do anunciante, o público total do Pinterest ou o endpoint de escopo/tipo. O Pinterest fixa a janela de observação de insights de público; não é um relatório de intervalo de datas personalizado.
• pinterest_get_audiences: Ler inventário de público, lista de clientes, compartilhamento e público recebido pelo Business sem enviar ou alterar a associação do público.
• pinterest_get_billing_and_orders: Ler perfis/faturas de cobrança, URLs de download de faturas, linhas de pedido, descontos de créditos de anúncios e status de conta/pedido SSIO. Os dados financeiros são retornados somente quando o token tem acesso à conta.
• pinterest_get_business_assets: Ler inventário de Acesso Empresarial do Pinterest: empregadores/empresas vinculadas, ativos, membros, parceiros, ativos atribuídos, públicos recebidos e convites. Requer as permissões correspondentes de gerenciamento empresarial.
• pinterest_get_catalog_diagnostics: Ler inventário profundo de catálogo e diagnósticos: catálogos, feeds, resultados de processamento de feeds, problemas de itens, grupos de produtos, contagens/produtos, valores de filtro disponíveis e consultas de itens de catálogo. ITEMS é uma consulta POST somente leitura.
• pinterest_get_catalog_inventory: Listar superfícies de inventário de catálogo do Pinterest: catálogos, grupos de produtos, promoções de grupos de produtos e amostras opcionais de produtos.
• pinterest_get_conversion_setup: Inspecionar a configuração de medição de conversão do Pinterest: tags de conversão, tags elegíveis para oCPM/visitas de página, Event Quality Score, eventos definidos pelo anunciante e status de solicitação de exclusão de conversão. Isso nunca envia ou exclui eventos de conversão.
• pinterest_get_creative_assets: Buscar ativos criativos do Pinterest e desempenho do período quando disponíveis. Retorna anúncios, pins, miniaturas/imagens/vídeos, contexto de campanha/grupo de anúncios, sinais de catálogo e classificações de ativos.
• pinterest_get_delivery_metrics: Ler resources/delivery_metrics do Pinterest. Use para inspecionar os metadados oficiais de métricas de entrega do Pinterest para relatórios síncronos ou assíncronos.
• pinterest_get_keyword_intelligence: Ler palavras-chave de segmentação atribuídas, métricas de palavras-chave em nível de país do Pinterest, termos sugeridos ou termos relacionados. As métricas de país aceitam até 2.000 palavras-chave por solicitação.
• pinterest_get_lead_assets: Ler definições de formulários de lead e configuração de assinatura de lead. A exportação de registros de lead é intencionalmente excluída porque pode conter PII do usuário final.
• pinterest_get_organic_inventory: Ler conteúdo orgânico do Pinterest usado junto com anúncios: Pins, boards, Pins em um board, tags de produto de Pin ou resultados de pesquisa. Isso é metadado de inventário, não prova de entrega paga.
• pinterest_get_pin_analytics: Ler análises de Pins pagos, análises orgânicas de Pin único/múltiplo, análises de conta de usuário, principais Pins ou principais Pins de vídeo. Passe nomes de métricas brutos suportados pelo endpoint selecionado do Pinterest.
• pinterest_get_platform_resources: Ler metadados de plataforma e recursos de prontidão do Pinterest: países suportados de contas de anúncios, definições de métricas de entrega, prontidão de métricas, perguntas de formulários de lead, metadados de upload de mídia, metadados de integração de comércio ou a conta de usuário autenticada.
• pinterest_get_targeting_options: Ler o catálogo oficial de opções de segmentação do Pinterest para tipo de aplicativo, gênero, idioma, idade, localização/geo, interesse, palavra-chave ou público. Também pode resolver um ID de interesse específico.
• pinterest_get_trends: Ler Tendências do Pinterest: principais palavras-chave em crescimento/mensais/anuais/sazonais por região suportada, categorias de produtos em crescimento, detalhes de categorias de produtos, tópicos em destaque ou artigos editoriais.
• pinterest_get_write_schema: Ler o esquema oficial de solicitação nativa do Pinterest v5 e as limitações do Sandbox antes de compor uma escrita.
• pinterest_health_check: Verificação de saúde somente leitura dos Anúncios do Pinterest. Verifica credenciais configuradas, acesso à conta, acesso a métricas de entrega e legibilidade opcional da conta padrão sem expor tokens OAuth.
• pinterest_list_ad_accounts: Listar contas de anúncios do Pinterest acessíveis às credenciais configuradas.
• pinterest_list_ad_creatives: Listar os criativos de anúncios da conta de anúncios em todos os status (a API omite silenciosamente anúncios ARQUIVADOS, a menos que solicitado) com sua mídia de pin resolvida: URLs públicas de imagem i.pinimg.com de até 1200px, capa de vídeo e video_url quando o aplicativo tem permissão para lê-la. Formatos orientados por catálogo são excluídos por padrão.
• pinterest_register_media (write): Registrar upload de mídia; upload_url/parâmetros retornados não são confirmação de que um vídeo foi enviado ou está pronto. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_run_catalog_report: Executar relatórios de catálogo do Pinterest por PRODUCT_GROUP ou PRODUCT_ITEM. O histórico de PRODUCT_ITEM é limitado a 92 dias antes de hoje (UTC), com solicitações divididas em janelas de 31 dias; o desempenho mais antigo de itens não pode ser recuperado por novas tentativas. Use PRODUCT_GROUP para totais de entrega de catálogo mais antigos, não desempenho individual de SKU.
• pinterest_run_conversion_product_report: Executar relatórios assíncronos de conversão de produtos do Pinterest por marca, categoria, marca+categoria, SKU ou grupo de SKU via reports/brand_category_sku. Este é um recurso restrito do Pinterest: o acesso padrão à API sozinho não garante disponibilidade para o cliente. É separado do relatório de gastos de PRODUCT_ITEM.
• pinterest_run_report: Executar um relatório somente leitura de Anúncios do Pinterest. Roteia automaticamente solicitações antigas/amplas ou assíncronas explícitas através de relatórios assíncronos do Pinterest. Usa nomes brutos de colunas de relatórios do Pinterest.
• pinterest_run_specialized_export: Iniciar ou inspecionar trabalhos de dados não mutantes do Pinterest para Marketing Mix Modeling (MMM), downloads em massa de entidades de anunciantes ou diagnósticos de catálogo. START cria apenas um artefato de relatório/exportação; nunca atualiza entidades de entrega.
• pinterest_run_targeting_report: Executar análises de segmentação ao vivo para uma conta de anúncios, campanhas, grupos de anúncios ou anúncios, divididas por idade, gênero, localização, interesse, palavra-chave, público, posicionamento, dispositivo ou outros tipos de segmentação do Pinterest. Para dados mais antigos que a janela síncrona, use pinterest_run_report com targetingTypes e executionMode=async.
• pinterest_update_ad (write): Atualizar configurações nativas de anúncio. Leia a entidade existente primeiro; especificações aninhadas podem substituir valores existentes. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_update_ad_status (write): Atualizar o status de um anúncio existente. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_update_adgroup_budget (write): Definir exatamente um orçamento diário ou vitalício de grupo de anúncios em unidades principais da moeda da conta. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_update_adgroup_configuration (write): Atualizar configurações nativas de grupo de anúncios. Leia a entidade existente primeiro; especificações aninhadas podem substituir valores existentes. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_update_adgroup_status (write): Atualizar o status de um grupo de anúncios existente. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_update_board (write): Atualizar /boards no contexto do anunciante selecionado. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_update_campaign_budget (write): Definir exatamente um orçamento diário ou vitalício de campanha em unidades principais da moeda da conta. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_update_campaign_configuration (write): Atualizar configurações nativas de campanha. Leia a entidade existente primeiro; especificações aninhadas podem substituir valores existentes. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_update_campaign_status (write): Atualizar o status de uma campanha existente. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_update_catalog_feed (write): Atualizar /catalogs/feeds no contexto do anunciante selecionado. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_update_pin (write): Atualizar um Pin. Requer o direito restrito pin_edit do Pinterest além de pins:write; somente Standard é insuficiente. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_update_product_group (write): Atualizar /catalogs/product_groups no contexto do anunciante selecionado. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_update_product_group_promotion (write): Atualizar uma promoção de grupo de produtos de catálogo. Indisponível no Sandbox. Visualização por padrão. Sem nova tentativa automática de mutação. Elegibilidade e escopos da API nativa ainda se aplicam.
• pinterest_validate_report: Validar e visualizar como um relatório do Pinterest será executado. Retorna roteamento síncrono/assíncrono, endpoint, nível, colunas, configurações de atribuição e avisos sem chamar endpoints de desempenho.

Google Ads (44 ferramentas, 10 de escrita)

Disponível para contas autorizadas e selecionadas.

• google_ads_apply_plan (gravação): Pré-visualize, valide e aplique atomicamente um plano de criação/alteração do Google Ads v25: campanhas, orçamentos, grupos de anúncios, anúncios RSA/Display/Demand Gen, assets de imagem/texto/YouTube, grupos de assets e links do PMax, palavras-chave, grupos de listagem de segmentação geográfica/idioma e configuração de ações de conversão (sem uploads de eventos de conversão). Campos nativos REST em camelCase; valores são micros inteiros da moeda explicitamente informada. Suporta IDs de recursos negativos temporários para criação ordenada em uma única transação. Sem criação de campanhas de VÍDEO (restrição da API do Google), cobrança, alterações de acesso à conta, listas de clientes ou uploads de conversão. Novas campanhas/grupos/anúncios são sempre PAUSADOS. Chame primeiro sem confirm para inspecionar o plano e obter o planHash; validateOnly consulta o Google sem aplicar; a execução exige confirm e o expectedPlanHash correspondente. Leia os resultados com google_ads_run_gaql. Nunca repita uma criação após um resultado de rede incerto antes de verificar o nome/IDs.
• google_ads_create_campaign (gravação): Crie uma campanha do Google Ads. Ela é sempre criada PAUSADA e não há opção de criá-la ativa: alguém precisa revisá-la antes que ela gaste. Também cria o orçamento da campanha. Pré-visualiza por padrão.
• google_ads_generate_ad_group_themes: Organize palavras-chave fornecidas em grupos de anúncios existentes do Google Ads. Retorna sugestões de pares grupo de anúncios/campanha, texto normalizado da palavra-chave e tipo de correspondência sugerido, sem criar ou editar palavras-chave. RPC somente leitura do Keyword Planner.
• google_ads_generate_keyword_forecast_metrics: Preveja impressões, cliques, CTR, CPC, custo, conversões e CPA para uma campanha temporária de palavras-chave. Suporta segmentação, negativas, tipo de correspondência, três estratégias de lances, datas futuras explícitas e uma análise independente opcional por palavra-chave. Este RPC somente leitura, sem plano, não cria campanha nem plano salvo.
• google_ads_generate_keyword_historical_metrics: Obtenha o histórico de volume de pesquisa do Keyword Planner para palavras-chave fornecidas. Retorna médias mensais de pesquisas, volumes mensais (até 48 meses), volume mais recente, variações calculadas de 3 meses e YoY, concorrência, faixas de CPC/lance, variantes próximas e totais por dispositivo opcionais. Este é um RPC somente leitura, sem plano.
• google_ads_generate_keyword_ideas: Descubra ideias do Keyword Planner a partir de até 20 palavras-chave semente, uma URL, palavras-chave mais URL ou um site inteiro. Retorna volume histórico, tendências mensais, variações calculadas de 3 meses/YoY, concorrência, lances, variantes próximas, conceitos opcionais e paginação. Somente leitura; nenhum plano é salvo.
• google_ads_get_account_details: Obtenha informações detalhadas de uma conta de cliente específica do Google Ads.
• google_ads_get_account_hierarchy: Liste clientes acessíveis e, quando possível, relações gerente/cliente do GAQL customer_client. Recorre a clientes acessíveis se consultas de hierarquia não estiverem disponíveis.
• google_ads_get_adgroups: Liste grupos de anúncios de uma conta do Google Ads, opcionalmente filtrados por campanha.
• google_ads_get_bidding_strategies: Liste estratégias de lances de portfólio. Inclui métricas somente quando startDate/endDate são fornecidos; caso contrário, retorna apenas a estrutura.
• google_ads_get_budgets: Liste orçamentos de campanha com valor, status, método de entrega e campos de orçamento recomendado quando suportados.
• google_ads_get_campaigns: Liste campanhas de uma conta do Google Ads com status, orçamento, tipo de canal e estratégia de lances.
• google_ads_get_change_events: Busque linhas recentes de change_event. Aplica restrições do Google Ads: janela de datas dentro dos últimos 30 dias e LIMIT <= 10000.
• google_ads_get_conversion_actions: Liste ações de conversão com status, tipo, categoria, flags primária/incluir em conversões, cliente proprietário e datas de última atividade quando suportadas.
• google_ads_get_demand_gen_assets: Liste anúncios Demand Gen (vídeo responsivo, multi-asset, carrossel) com seus criativos referenciados resolvidos: URLs estáveis de imagem e IDs de vídeo do YouTube com URLs de incorporação e miniatura. Complementa o google_ads_get_pmax_assets, que cobre Performance Max.
• google_ads_get_insights: Consulte insights de desempenho do Google Ads com planejamento inteligente de consultas. Gera GAQL automaticamente e lida com incompatibilidades de métrica/segmento dividindo consultas. Use google-ads://metrics para métricas disponíveis e google-ads://dimensions para dimensões.
• google_ads_get_keyword_performance: Obtenha dados de desempenho no nível da palavra-chave do recurso keyword_view. Mostra qualidade do anúncio, impressões, cliques e custo.
• google_ads_get_landing_pages: Busque desempenho de landing_page_view com URL final, contexto de campanha/grupo de anúncios, tráfego, conversões e métricas de qualidade da página de destino quando suportadas.
• google_ads_get_paid_organic_search_terms: Relatório somente leitura de termos de pesquisa pagos/orgânicos. Usa paid_organic_search_term_view quando disponível e recorre a search_term_view somente pago se campos orgânicos não estiverem disponíveis.
• google_ads_get_pmax_asset_diagnostics: Diagnósticos somente leitura de grupos de assets do Performance Max. Retorna força do anúncio, itens de ação de cobertura de assets, motivos de status primário, métricas de desempenho opcionais e combinações principais de assets opcionais.
• google_ads_get_pmax_assets: Liste assets de grupos de assets do Performance Max de asset_group_asset com contexto de grupo de assets/campanha e métricas de desempenho opcionais por intervalo de datas.
• google_ads_get_pmax_placements: Diagnósticos somente leitura de posicionamento do Performance Max de performance_max_placement_view. Retorna tipo de posicionamento, nome de exibição, URL de destino, contexto de campanha e apenas impressões.
• google_ads_get_recommendations: Liste recomendações do Google Ads com tipo, recurso, links de campanha/grupo de anúncios, estado de dispensado e impacto quando suportado.
• google_ads_get_search_terms: Busque desempenho de termos de pesquisa de search_term_view ou campaign_search_term_insight dependendo do reportType.
• google_ads_get_shopping_performance: Relatório somente leitura de desempenho de Shopping, organizado por dimensões de produto do Merchant Center. Útil para unir gastos/conversões a ID do comerciante, ID do item, título, marca, rótulo do feed e rótulos personalizados.
• google_ads_get_shopping_products: Relatório somente leitura de catálogo/qualificação de produtos do Merchant Center via shopping_product. Suporta escopos de conta, campanha e grupo de anúncios com métricas de desempenho quando a conta tem dados de e-commerce Shopping/PMax.
• google_ads_get_simulations: Consulta somente leitura de planejamento/previsão para simulações de lances de campanha, grupo de anúncios ou portfólio. Retorna metadados de simulação e listas de pontos projetados quando disponíveis, com fallback de metadados.
• google_ads_health_check: Verificação de conectividade somente leitura. Verifica presença de credenciais, acesso à API do Google Ads, visibilidade do cliente de login, versão da API e avisos acionáveis sem retornar segredos.
• google_ads_list_accounts: Liste contas de clientes do Google Ads acessíveis com as credenciais atuais. Se um cliente acessível for uma conta de gerente, também tenta incluir contas filhas habilitadas de customer_client.
• google_ads_list_image_assets: Liste a biblioteca de assets de imagem da conta (FROM asset) com URLs estáveis de tamanho completo servidas publicamente em tpc.googlesyndication.com, dimensões, tamanho do arquivo e tipo MIME. Este é o estoque completo e não carrega noção de entrega: um asset enviado em 2022 e nunca servido aparece exatamente como um em execução hoje. Mais recentes primeiro, então um limite retorna assets recentes em vez de uma fatia arbitrária, e a contagem na resposta é o total da conta. Para uma galeria somente visual de assets com entrega ao longo de datas, use get_creative_gallery (cobertura do Performance Max). Solicite get_creative_performance somente quando cartões de KPI forem desejados. Imagens de produtos de Shopping vivem no Merchant Center, não nesta biblioteca.
• google_ads_list_video_assets: Liste os assets de vídeo do YouTube da conta (FROM asset) com URLs derivadas de assistir, incorporar e miniatura pública. Este é o estoque completo e não carrega noção de entrega: um asset enviado anos atrás e nunca servido aparece exatamente como um em execução hoje. Mais recentes primeiro, então um limite retorna assets recentes em vez de uma fatia arbitrária, e a contagem na resposta é o total da conta. Para uma galeria somente visual de assets com entrega ao longo de datas, use get_creative_gallery (cobertura do Performance Max). Solicite get_creative_performance somente quando cartões de KPI forem desejados. O Google Ads não expõe arquivo de vídeo para download: vídeos de PMax e Demand Gen são hospedados no YouTube, então exiba-os via incorporação ou miniaturas.
• google_ads_remove_video_upload (gravação): Remova um upload de vídeo de propriedade da conta de anúncios selecionada. Exclui o vídeo do YouTube enviado e pode quebrar anúncios que o referenciam. Pré-visualização e expectedPlanHash correspondente são necessários. O Google v25 marca título/descrição como imutáveis; esta ferramenta não finge editá-los.
• google_ads_rename_campaign (gravação): Renomeie uma campanha do Google Ads. O nome é a única coisa que muda: entrega, orçamento e segmentação permanecem intactos. Pré-visualiza por padrão.
• google_ads_run_gaql: Execute uma consulta GAQL bruta (Google Ads Query Language). Flexibilidade total para qualquer necessidade de relatório. Exemplo: SELECT campaign.name, metrics.impressions FROM campaign WHERE campaign.status = 'ENABLED' AND segments.date DURING LAST_30_DAYS ORDER BY metrics.impressions DESC LIMIT 100.
• google_ads_run_readonly_rpc: Saída de escape avançada somente leitura para serviços do Google Ads na lista de permissões fora do GAQL: Audience Insights, Reach Planner, benchmarks, insights de criadores/tendências, sugestões de segmentação, sugestões de Smart Campaign, verificação de identidade, faturas e contas de pagamentos. A operação é um enum; caminhos arbitrários e todas as mutações/uploads são impossíveis.
• google_ads_search_fields: Pesquise o catálogo ao vivo do GoogleAdsField do Google. Descobre todos os recursos GAQL consultáveis, atributos, segmentos, métricas, valores de enum e relações de compatibilidade selecionável-com. Somente leitura e útil antes de uma consulta GAQL bruta.
• google_ads_suggest_geo_targets: Resolva até 25 nomes de locais ou IDs de segmentação geográfica para geoTargetConstants do Google Ads. Retorna IDs de critério, nomes canônicos, tipos de destino, status, pais, localidade e alcance aproximado. Somente leitura.
• google_ads_update_adgroup_bid (gravação): Altere o lance de CPC padrão de um grupo de anúncios do Google Ads. O valor está na moeda da conta (1.20 para 1.20 EUR). Não tem efeito em uma campanha que usa estratégia de lances automatizada. Pré-visualiza por padrão.
• google_ads_update_adgroup_status (gravação): Pause, reative ou remova um grupo de anúncios do Google Ads. Pré-visualiza por padrão.
• google_ads_update_campaign_budget (gravação): Altere o orçamento diário de uma campanha do Google Ads. O valor está na moeda da conta (12.50 para 12.50 EUR). Pré-visualiza por padrão.
• google_ads_update_campaign_schedule (gravação): Altere a data de início ou término de uma campanha do Google Ads. As datas estão no formato YYYY-MM-DD no fuso horário da conta. Pré-visualiza por padrão.
• google_ads_update_campaign_status (gravação): Pause, reative ou remova uma campanha do Google Ads. Pré-visualiza por padrão: sem confirm: true, a ferramenta descreve a alteração sem aplicá-la.
• google_ads_upload_video (gravação): Envie bytes de MP4/WebM/QuickTime (máx. 16 MiB) para o canal do YouTube gerenciado pelo Google da conta de anúncios selecionada. A visibilidade é NÃO LISTADA: visível para qualquer pessoa com o link, não privada. A pré-visualização padrão omite bytes e retorna planHash; confirm exige expectedPlanHash. Esta API não tem validateOnly. Após o upload, consulte you_tube_video_upload.state e video_id com google_ads_run_gaql; use o ID do vídeo somente após PROCESSED, via google_ads_apply_plan assetOperation.youtubeVideoAsset. Sem nova tentativa automática após um upload incerto.
• google_ads_validate_query: Valide a compatibilidade de métrica/dimensão/recurso ANTES de executar uma consulta. Verifica restrições de segmento e disponibilidade de recursos.

TikTok Ads (60 ferramentas, 27 gravação)

Disponível para contas autorizadas e selecionadas.

• tiktok_create_adgroup (write): Cria grupo de anúncios clássico do TikTok desativado. Não há opção de ativar. A elegibilidade nativa de objetivo/formato é aplicada pelo TikTok. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_create_ads (write): Cria anúncios clássicos do TikTok desativados (vídeo, imagem, carrossel ou conteúdo Spark autorizado). Não há opção de ativar. A elegibilidade nativa de objetivo/formato é aplicada pelo TikTok. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_create_campaign (write): Cria uma campanha do TikTok. Ela é sempre criada desativada e não há opção de criá-la em execução. Pré-visualizações por padrão.
• tiktok_create_campaign_advanced (write): Cria campanha clássica do TikTok desativada. Não há opção de ativar. A elegibilidade nativa de objetivo/formato é aplicada pelo TikTok. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_create_smart_plus_ad (write): Cria anúncios Smart+ atualizados do TikTok desativados (vídeo, imagem, carrossel ou conteúdo Spark autorizado). Não há opção de ativar. A elegibilidade nativa de objetivo/formato é aplicada pelo TikTok. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_create_smart_plus_adgroup (write): Cria grupo de anúncios Smart+ atualizado do TikTok desativado. Não há opção de ativar. A elegibilidade nativa de objetivo/formato é aplicada pelo TikTok. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_create_smart_plus_campaign (write): Cria campanha Smart+ atualizada do TikTok desativada. Não há opção de ativar. A elegibilidade nativa de objetivo/formato é aplicada pelo TikTok. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_get_adgroups: Lê a configuração completa do grupo de anúncios nativo, incluindo segmentação, referências de público personalizado/ semelhante e exclusões, geografia, idioma, idade/gênero, posicionamentos, interesses/comportamentos, orçamento e programação. Defina smartPlus:true para targeting_spec do Smart+ atualizado. Campos ausentes são desconhecidos, não segmentação irrestrita. Paginado.
• tiktok_get_ads: Lista anúncios de um anunciante do TikTok. Retorna ID do anúncio, nome, status de operação e informações do criativo.
• tiktok_get_advertiser_info: Obtém informações detalhadas de contas específicas de anunciante do TikTok: moeda, fuso horário, status, saldo.
• tiktok_get_asset_urls: Re-resolve URLs novas e publicamente buscáveis para ativos específicos da biblioteca do TikTok (file/video/ad/info e file/image/ad/info). Chame no momento da exibição ou download: toda URL de mídia do TikTok é assinada e expira.
• tiktok_get_async_report_status: Verifica o status de uma tarefa de relatório assíncrono do TikTok por taskId quando os endpoints de relatório assíncrono estão disponíveis. Nenhuma criação ou mutação de relatório é realizada.
• tiktok_get_audience_details: Obtém detalhes de públicos personalizados/semelhantes/salvos onde os endpoints DMP do TikTok estão acessíveis. Somente leitura.
• tiktok_get_audience_overlap: Diagnóstico somente leitura de sobreposição de públicos entre grupos de anúncios, públicos personalizados, públicos salvos e campos de segmentação.
• tiktok_get_audience_report: Lê relatórios de desempenho de AUDIENCE do TikTok por idade ou gênero no nível de anunciante, campanha, grupo de anúncios ou anúncio, incluindo entrega de campanhas Smart+ elegíveis. Demografias múltiplas retornam relatórios separados, não uma distribuição conjunta. Paginação explícita e erros nativos do provedor; sem inferência de segmentação configurada ou associação a público personalizado.
• tiktok_get_audiences: Lista públicos personalizados e semelhantes para uma conta de anunciante do TikTok.
• tiktok_get_campaigns: Lista campanhas para uma conta de anunciante do TikTok. Retorna ID da campanha, nome, status, orçamento e objetivo.
• tiktok_get_creative_fatigue_recipes: Encontra padrões prováveis de fadiga criativa a partir de relatórios diários no nível de anúncio e retorna receitas de atualização somente leitura. Não cria, edita ou envia criativos.
• tiktok_get_creatives: Obtém detalhes do criativo (vídeo, imagem, texto) para anúncios específicos em uma conta de anunciante do TikTok.
• tiktok_get_delivery_status: Agrega status de entrega/operation_status de campanha, grupo de anúncios e anúncio com diagnósticos simples.
• tiktok_get_entities_raw: Lista campanhas, grupos de anúncios ou anúncios do TikTok com campos nativos selecionados pelo chamador, filtragem, ordenação e paginação. Esta saída somente GET expõe campos de entidade recém-lançados sem esperar pelos esquemas selecionados do MCP.
• tiktok_get_events: Descobre eventos de pixel/app ou diagnósticos de rastreamento acessíveis para um anunciante. Usa verificações de endpoint de melhor esforço mais dimensões de relatório como fallback.
• tiktok_get_insights: Consulta insights de desempenho de anúncios do TikTok usando o catálogo atual de métricas nativas/calculadas e planejamento de consultas. Use o recurso tiktok://metrics para ver métricas disponíveis. Use tiktok://dimensions para dimensões. Dimensões de idade/gênero roteiam automaticamente para relatórios AUDIENCE via tiktok_get_audience_report, incluindo níveis de campanha/grupo de anúncios. Outras dimensões usam o planejador BASIC. Várias divisões de público permanecem relatórios separados, nunca unidos.
• tiktok_get_pixels: Lista pixels do TikTok e, quando as permissões permitirem, metadados de eventos de pixel para um anunciante. Faz fallback com avisos explícitos quando os endpoints não estão disponíveis.
• tiktok_get_read_endpoint: Saída GET avançada somente leitura da API de Negócios do TikTok para endpoints JSON de leitura documentados ainda não modelados por uma ferramenta MCP especializada. Caminhos relativos v1.3 e parâmetros de consulta compatíveis com JSON são validados; OAuth, mutações, downloads e caminhos de registros de leads são bloqueados.
• tiktok_get_report_raw: Executa um relatório síncrono nativo BASIC ou AUDIENCE do TikTok com dimensões e métricas selecionadas pelo chamador. AUDIENCE suporta demografias como idade/gênero nos níveis de campanha/grupo de anúncios; tiktok_get_audience_report fornece um caminho guiado. Use quando um campo de API atual ainda não estiver em tiktok://metrics; ao contrário de tiktok_get_insights, esta ferramenta não calcula aliases nem divide automaticamente seleções incompatíveis.
• tiktok_get_search_ads_maturity: Diagnostica a maturidade dos Anúncios de Pesquisa do TikTok a partir de relatórios de palavras-chave/termos de pesquisa e endpoints opcionais de recomendação de palavras-chave. Somente diagnósticos de leitura.
• tiktok_get_shop_catalog_diagnostics: Diagnósticos somente leitura de TikTok Shop/catálogo/e-commerce. Tenta relatórios de catálogo primeiro, depois métricas de leilão da Shop, e retorna avisos de endpoint quando as permissões de catálogo não estão disponíveis.
• tiktok_get_spark_ads: Retorna o contexto dos Spark Ads a partir dos campos do anúncio quando disponível, com fallback conservador se os campos específicos de Spark não forem suportados.
• tiktok_get_spark_organic_joins: Junta campos acessíveis de Spark Ads com relatórios de página/publicação pagos e endpoints opcionais de identidade/publicação orgânica quando as permissões permitirem. Somente leitura.
• tiktok_get_targeting: Lê a segmentação configurada do grupo de anúncios e referências de público: inclusões/exclusões personalizadas/semelhantes, geografia, idioma, idade/gênero, posicionamentos, interesses e comportamentos. Suporta clássico e Smart+ atualizado (smartPlus:true), preservando targeting_spec e configurações de segmentação automática. Não infere públicos entregues ou sinais ocultos do Smart+. Use tiktok_get_audiences para nomes/tipos de público e tiktok_get_audience_report para demografias entregues.
• tiktok_get_targeting_catalog: Lê catálogos de segmentação e planejamento do TikTok: locais, idiomas, interesses, comportamentos, hashtags, ideias/saúde de palavras-chave de Anúncios de Pesquisa, dispositivos, operadoras, tags contextuais, exclusões de conteúdo e fusos horários.
• tiktok_get_video_assets: Retorna metadados de ativos de vídeo do TikTok vinculados a anúncios a partir de ad/get e endpoints de material de vídeo quando disponíveis.
• tiktok_get_write_context: Lê a entidade exata do TikTok, configurações do pai e moeda/fuso horário do anunciante antes de editar ou construir uma nova configuração. Somente leitura.
• tiktok_health_check: Verificação de saúde somente leitura para credenciais do TikTok, anunciantes acessíveis e informações do anunciante. Nunca retorna tokens ou segredos.
• tiktok_list_ad_images: Lista toda a biblioteca de imagens do anunciante (file/image/ad/search): nome do arquivo, dimensões, assinatura, usabilidade em carrossel e uma URL de imagem servida publicamente assinada por aproximadamente trinta dias (image_url_expires_at dá o instante exato).
• tiktok_list_ad_videos: Lista toda a biblioteca de vídeos do anunciante (file/video/ad/search): nome do arquivo, duração, dimensões, assinatura e URLs de pré-visualização e capa servidas publicamente. Toda URL do TikTok é assinada e expira após aproximadamente seis horas: re-resolva com tiktok_get_asset_urls antes do uso.
• tiktok_list_advertisers: Lista todas as contas de anunciante do TikTok acessíveis com o token atual. Retorna ID do anunciante, nome e status.
• tiktok_rename_ad (write): Renomeia um anúncio clássico do TikTok. Não altera orçamento, conteúdo criativo ou status. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_rename_adgroup (write): Renomeia um grupo de anúncios clássico do TikTok. Não altera orçamento, conteúdo criativo ou status. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_rename_campaign (write): Renomeia uma campanha clássica do TikTok. Não altera orçamento, conteúdo criativo ou status. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_search_keywords: Obtém sugestões de palavras-chave para Anúncios de Pesquisa do TikTok. Retorna palavras-chave recomendadas com estimativas de volume de pesquisa.
• tiktok_update_ad_status (write): Pausa ou reativa exatamente um anúncio clássico. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_update_adgroup_budget (write): Altera o orçamento de um grupo de anúncios do TikTok. Valor na moeda da conta, enviado como está. Pré-visualizações por padrão.
• tiktok_update_adgroup_configuration (write): Atualiza grupo de anúncios clássico do TikTok. O status não é alterado. A elegibilidade nativa de objetivo/formato é aplicada pelo TikTok. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_update_adgroup_status (write): Pausa ou reativa um grupo de anúncios do TikTok. Pré-visualizações por padrão.
• tiktok_update_ads (write): Atualiza anúncios clássicos do TikTok (vídeo, imagem, carrossel ou conteúdo Spark autorizado). O status não é alterado. A elegibilidade nativa de objetivo/formato é aplicada pelo TikTok. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_update_campaign_budget (write): Altera o orçamento de uma campanha do TikTok, na moeda da conta. Pré-visualizações por padrão.
• tiktok_update_campaign_configuration (write): Atualiza campanha clássica do TikTok. O status não é alterado. A elegibilidade nativa de objetivo/formato é aplicada pelo TikTok. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_update_campaign_status (write): Pausa ou reativa uma campanha do TikTok. Pré-visualizações por padrão.
• tiktok_update_smart_plus_ad (write): Atualiza anúncios Smart+ atualizados do TikTok (vídeo, imagem, carrossel ou conteúdo Spark autorizado). O status não é alterado. A elegibilidade nativa de objetivo/formato é aplicada pelo TikTok. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_update_smart_plus_ad_status (write): Pausa ou reativa exatamente um anúncio Smart+. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_update_smart_plus_adgroup (write): Atualiza grupo de anúncios Smart+ atualizado do TikTok. O status não é alterado. A elegibilidade nativa de objetivo/formato é aplicada pelo TikTok. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_update_smart_plus_adgroup_status (write): Pausa ou reativa exatamente um grupo de anúncios Smart+. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_update_smart_plus_campaign (write): Atualiza campanha Smart+ atualizada do TikTok. O status não é alterado. A elegibilidade nativa de objetivo/formato é aplicada pelo TikTok. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_update_smart_plus_campaign_status (write): Pausa ou reativa exatamente uma campanha Smart+. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_update_smart_plus_material_status (write): Pausa ou reativa materiais criativos selecionados dentro de um anúncio Smart+ atualizado. Campanha pai, grupo de anúncios e status do anúncio não são alterados; o ativo compartilhado da biblioteca não é modificado. Pré-visualização local por padrão. Sem nova tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_upload_ad_image (write): Importe uma imagem de uma URL de mídia HTTPS pública ou arquivo base64 (até 5 MiB). O TikTok pode processá-la de forma assíncrona; a aceitação não é prova de que a mídia está pronta. Visualização local por padrão. Sem tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_upload_ad_video (write): Importe um vídeo de uma URL de mídia HTTPS pública ou arquivo base64 (até 5 MiB). O TikTok pode processá-lo de forma assíncrona; a aceitação não é prova de que a mídia está pronta. Visualização local por padrão. Sem tentativa automática; a propriedade do anunciante é verificada antes da aplicação.
• tiktok_validate_query: Valide uma combinação de métrica/dimensão do TikTok ANTES de executar. Verifica regras de agrupamento de dimensões, compatibilidade com o período de vida e compatibilidade entre métrica e dimensão.

Search Console (18 ferramentas, 0 gravação)

Disponível para contas autorizadas e selecionadas.

• gsc_analyze_search_appearance_trends: Analise dados estruturados e sinais de tendência de resultados avançados por meio da dimensão searchAppearance do Search Analytics quando o GSC a expõe.
• gsc_bulk_inspect_urls: Inspecione várias URLs com um limite sequencial conservador e resultados normalizados de Inspeção de URL. Cota: 2000 solicitações/dia/propriedade.
• gsc_cluster_queries: Agrupe consultas do Search Console por tokens simples e sinais de intenção: marca/não marca, pergunta, categoria e tokens de tópico.
• gsc_compare_search_types: Compare o desempenho entre os tipos de pesquisa do Search Console: web, imagem, vídeo, notícias, discover e Google News.
• gsc_detect_cannibalization: Detecte consultas em que várias páginas competem por cliques/impressões nas linhas de consulta-página do Search Analytics.
• gsc_find_losses_gains: Compare dois períodos para desempenho de consulta ou página e retorne deltas de cliques/impressões/CTR/posição.
• gsc_get_data_freshness: Detecte a data mais recente com dados do Search Analytics consultando linhas diárias recentes.
• gsc_get_sitemap_health: Retorne um resumo enriquecido e somente leitura da saúde do sitemap com totais de status, contagens de conteúdo enviado/indexado, avisos e erros.
• gsc_health_check: Verifique a autenticação somente leitura do Google Search Console, propriedades visíveis, site padrão configurado e níveis de permissão sem expor tokens.
• gsc_indexation_watchlist: Lista de observação somente leitura de Inspeção de URL para URLs críticas. Inspeciona até 10 URLs e retorna avaliações de alerta/revisão/ok sem armazenar estado.
• gsc_inspect_url: Inspecione uma URL para status de indexação do Google, informações de rastreamento, usabilidade móvel, AMP e resultados avançados. Cota: 2000 solicitações/dia/propriedade.
• gsc_list_sitemaps: Liste sitemaps enviados para uma propriedade do Search Console, incluindo status de processamento e contagens de enviado/indexado.
• gsc_list_sites: Liste todas as propriedades do Google Search Console acessíveis com as credenciais atuais.
• gsc_monitor_indexation_freshness: Snapshot de monitoramento somente leitura para atualização do Search Analytics, totais de indexação de sitemap e uma amostra opcional e pequena de Inspeção de URL.
• gsc_plan_large_site_sampling: Crie um plano de amostragem somente leitura de Inspeção de URL para sites grandes a partir de sinais de risco do sitemap e desempenho de página do Search Analytics.
• gsc_query_search_analytics: Consulte o Search Analytics do Google Search Console. Retorna cliques, impressões, CTR e posição média para consultas, páginas, países, dispositivos, datas e aparências de pesquisa. Use gsc://metrics, gsc://dimensions, gsc://filters e gsc://compatibility para campos e regras disponíveis.
• gsc_track_sitemap_deltas: Rastreador de delta de sitemap somente leitura. Busca o snapshot atual do sitemap e o compara com uma linha de base fornecida pelo agente; nenhum estado é gravado.
• gsc_validate_query: Valide uma combinação de métrica/dimensão/tipo de pesquisa do Search Console antes de executá-la.

Google Analytics 4 (27 ferramentas, 0 gravação)

Disponível para contas autorizadas e selecionadas.

• ga4_batch_run_pivot_reports: Execute 1-5 relatórios pivot GA4 independentes e somente leitura para a mesma propriedade em uma única solicitação em lote oficial da Data API.
• ga4_batch_run_reports: Execute 1-5 relatórios Core GA4 independentes e somente leitura para a mesma propriedade em uma única solicitação em lote oficial da Data API.
• ga4_check_compatibility: Pergunte à Data API oficial do GA4 quais dimensões e métricas são compatíveis com uma seleção de relatório Core proposta.
• ga4_get_audience_diagnostics: Diagnóstico somente leitura de públicos da Admin API audiences, listas de públicos recorrentes da Data API e fallback observado de relatório audienceName.
• ga4_get_audience_export_diagnostics: Diagnóstico somente leitura de Audience Export. Lista exportações de públicos existentes, contagens de estado e, opcionalmente, amostra linhas de uma exportação existente.
• ga4_get_bigquery_export_diagnostics: Detecte links de exportação do BigQuery do GA4 e diagnostique modos de exportação, cobertura de fluxo, eventos excluídos e localização do conjunto de dados.
• ga4_get_channel_groups: Liste grupos de canais personalizados definidos para uma propriedade GA4.
• ga4_get_custom_definitions: Liste dimensões personalizadas e métricas personalizadas expostas pelos metadados da Data API do GA4. Fallback somente leitura para inventário de definições personalizadas.
• ga4_get_ecommerce_diagnostics: Diagnóstico somente leitura de cobertura de ecommerce para eventos principais de ecommerce, métricas de receita e relatórios em nível de item em um intervalo de datas.
• ga4_get_event_parameters: Inventário de parâmetros de eventos de melhor esforço a partir de metadados do GA4 e relatórios de eventos. Documenta limitações da Data API para parâmetros brutos.
• ga4_get_key_events: Inventarie eventos/conversões-chave do GA4 usando relatórios da Data API com reconhecimento de metadados. Retorna nomes e contagens de eventos de melhor esforço.
• ga4_get_metadata: Obtenha a lista completa de dimensões e métricas disponíveis para uma propriedade GA4 específica. Útil para descobrir dimensões/métricas personalizadas.
• ga4_get_property_configuration: Leia detalhes da propriedade GA4 e configurações selecionadas de singleton da Admin (atribuição, retenção, Google Signals, identidade de relatório ou configurações de dados fornecidos pelo usuário).
• ga4_get_property_quotas_snapshot: Leia o snapshot atual da cota da propriedade da Data API do GA4 a partir do endpoint oficial v1alpha. Isso não executa um relatório, mas o Google ainda cobra um token de cota de propriedade para a categoria com mais cota restante.
• ga4_get_server_side_tagging_diagnostics: Diagnóstico somente leitura de melhor esforço de marcação no servidor a partir de fluxos de dados, segredos do Measurement Protocol, regras de eventos e configurações de fluxo.
• ga4_health_check: Verificação de saúde somente leitura do GA4. Verifica credenciais configuradas, propriedades acessíveis e acesso a metadados/propriedade sem expor tokens OAuth.
• ga4_list_accounts: Liste contas brutas do Analytics Admin do GA4 acessíveis ao usuário autenticado (somente leitura, com paginação automática).
• ga4_list_admin_resources: Liste uma coleção Admin do GA4 na lista de permissões em modo somente leitura: fluxos, definições personalizadas, eventos-chave, públicos, links de produtos, anotações, grupos de canais, conjuntos de dados expandidos, configuração de subpropriedade/rollup e vínculos de acesso.
• ga4_list_audience_exports: Liste snapshots existentes de Audience Export do GA4 e listas de públicos recorrentes sem criar novas exportações.
• ga4_list_properties: Liste todas as propriedades GA4 acessíveis com as credenciais atuais. Retorna ID da propriedade, nome de exibição, fuso horário e moeda.
• ga4_query_audience_export: Consulte linhas de uma Audience Export existente do GA4. Identificadores de usuário/dispositivo são ocultados por padrão; inclua-os apenas por meio de aceitação explícita.
• ga4_run_advanced_funnel_report: Execute o endpoint runFunnelReport da Data API v1alpha do GA4 com breakdown/next-action opcional, com fallback para contagens de etapas somente leitura se indisponível.
• ga4_run_funnel_recipe: Execute uma receita de funil configurável somente leitura usando um relatório GA4 por etapa eventName/pagePath e retorne contagens simples de etapas.
• ga4_run_pivot_report: Execute um relatório pivot da Data API do GA4 somente leitura com filtros nativos, ordenação, estado de cota, vários intervalos de datas e até 250.000 células pivot. Cada pivot exige um limite explícito.
• ga4_run_realtime_report: Execute um relatório em tempo real da Data API do GA4 somente leitura. O tempo real suporta apenas um subconjunto limitado de dimensões e métricas.
• ga4_run_report: Execute um relatório de análise do GA4 com planejamento inteligente de consultas. Suporta 52 métricas, 63 dimensões, paginação automática. Use os recursos ga4://metrics e ga4://dimensions para campos disponíveis. Máximo de 9 dimensões + 10 métricas por solicitação.
• ga4_validate_query: Valide uma combinação de métrica/dimensão ANTES de executar. Verifica limites máximos (9 dimensões, 10 métricas), regras de ecommerce e compatibilidade de dimensões.