Ferramentas MCP

Previous Next

Catálogo de ferramentas (v1)

Note

Catálogo planejado para a v1 do servidor MCP. Os nomes e parâmetros abaixo refletem o plano de implementação e podem mudar até o lançamento.

Todas as ferramentas de consulta (leitura) aceitam um parâmetro opcional response_format (markdown ou json).

Campanhas

Ferramenta Descrição
adpulse_list_campaigns Lista as campanhas da organização ativa.
adpulse_get_campaign Detalhes de uma campanha específica (campaignId).

Relatórios

Todos os relatórios recebem campaignId e, opcionalmente, startDate/endDate.

Ferramenta Descrição
adpulse_get_general_report Relatório geral da campanha.
adpulse_get_pricing_model_report Relatório por modelo de precificação.
adpulse_get_delivery_by_day Veiculação por dia.
adpulse_get_delivery_by_publisher Veiculação por publisher.
adpulse_get_verification_report Relatório de verificação.
adpulse_get_impressions_by_geo Impressões por estado, país ou dispositivo (dimension).

Outros relatórios (páginas mais acessadas, bloqueios, heatmap, etc.) seguem o mesmo formato e serão adicionados após validação dos primeiros.

Veiculações (placements)

Ferramenta Descrição
adpulse_list_placements Lista as veiculações da organização.
adpulse_get_placement Detalhes de uma veiculação específica (placementId).

Organizações

Ferramenta Descrição
adpulse_get_active_organization Organização associada ao token atual.
adpulse_list_organizations Organizações às quais o usuário pertence.
adpulse_list_org_members Membros de uma organização.

Ações (escrita)

Na v1, a única ação disponível é o convite de membro para a organização, usando um fluxo de duas etapas (propor → confirmar) — nenhuma ação executa uma mudança imediatamente:

  1. adpulse_propose_invite_org_member (email, role opcional) — valida os dados e retorna um confirmationToken de uso único, válido por 5 minutos.
  2. adpulse_confirm_action (confirmationToken) — executa a ação proposta e retorna o resultado.

Escopo da v1

Ações de escrita sobre campanhas e veiculações (atualizar status, editar, excluir) não fazem parte da v1 — essas ferramentas estão disponíveis apenas como consulta por enquanto.