1. O que é o HilltopAds MCP e o que você pode fazer com ele

O que é o HilltopAds MCP?

O MCP Server (Model Context Protocol) é um conector oficial da HilltopAds para clientes de IA. Depois de conectado, a IA pode acessar os dados da sua conta e, com a sua autorização, realizar ações como criar ou atualizar campanhas por meio de um canal seguro e dedicado, sem que você precise copiar e colar informações manualmente.

Seu login e sua senha nunca são compartilhados com o cliente de IA. A conexão é autorizada por meio de uma chave de API que você gera na sua conta.

O conector disponibiliza sua conta da HilltopAds por meio de um conjunto de ferramentas (Tools). A IA escolhe automaticamente a ferramenta mais adequada para sua solicitação, executa a operação e apresenta o resultado em um formato fácil de entender, como uma tabela, um resumo ou até mesmo um gráfico.

O que você pode fazer com ele?

As ferramentas são divididas em dois tipos:

Operações de leitura (Read Operations): recuperam dados como saldo, inventário, estatísticas, detalhes de uma campanha específica ou listas de fontes de tráfego de uma campanha.

Operações de ação (Action Operations): fazem alterações na sua conta, como criar ou atualizar campanhas, iniciá-las ou pausá-las, ajustar lances (Bids), URLs de destino e gerenciar listas de bloqueio (Blacklists) e listas de permissão (Whitelists) de fontes de tráfego.

As ferramentas disponíveis dependem do tipo da sua conta: Anunciante (Advertiser), Publisher ou ambos. Atualmente, o conector oferece 27 operações, sendo 23 para anunciantes e 4 para publishers.

As Operações de ação só são executadas após a sua confirmação. Os clientes de IA identificam as ferramentas como somente leitura ou escrita/exclusão, solicitando sua aprovação antes de qualquer alteração.

Ferramentas de conta e relatórios

Ferramenta	O que faz
`advertiser_get_balance`	Exibe o saldo atual da conta de anunciante.
`advertiser_list_inventory`	Lista suas campanhas e respectivos anúncios.
`advertiser_get_stats`	Exibe estatísticas filtradas ou agrupadas por data, zona, GEO, campanha, sistema operacional, hora ou fonte de tráfego.
`advertiser_get_campaign`	Exibe todos os detalhes de uma campanha específica por meio do seu ID.

Ferramentas de gerenciamento de campanhas

Observação: Nos exemplos apresentados mais adiante neste guia, o assistente cria cada campanha como Inativa (Inactive) para que você possa revisá-la antes que ela comece a consumir orçamento. Esse é apenas um comportamento padrão escolhido pelo assistente, não uma regra fixa. Se você quiser que uma campanha seja criada inativa ou iniciada imediatamente, informe isso explicitamente na sua solicitação.

Ferramenta	O que faz
`advertiser_create_campaign`	Cria uma nova campanha.
`advertiser_update_campaign`	Atualiza parcialmente as configurações de uma campanha.
advertiser_start_campaign	Ativa uma campanha aprovada.
`advertiser_stop_campaign`	Pausa uma campanha em execução.
`advertiser_archive_campaign`	Move uma campanha para o arquivo.
`advertiser_unarchive_campaign`	Restaura uma campanha do arquivo.
`advertiser_set_bid`	Altera o lance (Bid) do Wildcard GEO.
`advertiser_set_destination_url`	Altera a URL de destino de uma campanha Popunder.
`advertiser_replace_domain`	Substitui um domínio em todos os anúncios da conta do anunciante.

Ferramentas de blacklist de fontes de tráfego

Ferramenta	O que faz
`advertiser_get_blacklist`	Exibe a blacklist de fontes de uma campanha.
`advertiser_add_to_blacklist`	Adiciona fontes à blacklist.
`advertiser_remove_from_blacklist`	Remove fontes da blacklist.
`advertiser_clear_campaign_blacklist`	Limpa a blacklist de uma campanha.
`advertiser_set_blacklist`	Substitui toda a blacklist e coloca a campanha no modo BLACKLIST.

Ferramentas de whitelist de fontes de tráfego

Ferramenta	O que faz
`advertiser_get_whitelist`	Exibe a whitelist de fontes de uma campanha.
`advertiser_add_to_whitelist`	Adiciona fontes à whitelist.
`advertiser_remove_from_whitelist`	Remove fontes da whitelist.
`advertiser_clear_campaign_whitelist`	Limpa a whitelist de uma campanha.
`advertiser_set_whitelist`	Substitui toda a whitelist e coloca a campanha no modo WHITELIST.