Referência das ferramentas MCP

O servidor MCP do TagServer fica em https://tgsr.com.br/mcp; cada ferramenta abaixo age sobre a conta escolhida. Para conectar um cliente de IA e fazer login, veja Conectando uma IA (MCP).

Como ler esta referência

Os nomes em inglês (list_links, upsert_pixel) são os nomes técnicos das ferramentas que a IA chama; você os usa para conferir o que a IA está fazendo.
Quase toda ferramenta pede a conta sobre a qual agir; a IA descobre as contas acessíveis com list_accounts e usa o nome retornado.
Algumas ações são restritas por nível de acesso (dono, admin, Standard) ou exigem o recurso WebTracking na conta. A coluna "O que faz" marca quando for o caso.

Contas

Ferramenta	O que faz
`list_accounts`	Lista todas as contas que o usuário autenticado pode acessar.
`get_account`	Detalhes de uma conta.
`create_account`	Cria uma nova conta de propriedade do usuário autenticado; só precisa do nome da conta. Não cria um usuário novo: adiciona mais uma conta ao usuário existente.
`update_account`	Renomeia uma conta no lugar, sem duplicá-la.
`account_blocked_stats`	Estatísticas de tráfego bloqueado da conta, com janela de tempo opcional (since/until) e intervalo de agregação (step).
`set_account_owner`	Transfere a posse da conta a um usuário membro pelo e-mail (o usuário precisa ter e-mail verificado). Apenas dono: um admin não pode transferir a posse. O dono atual é rebaixado para acesso `Standard`; só o novo dono pode devolver a posse.

Usuários

Ferramenta	O que faz
`list_users`	Lista os usuários de uma conta. Níveis de acesso: `Owner` (dono, único por conta), `Admin` (tudo o que o dono faz, exceto transferir a posse; a conta pode ter vários), `Standard` (leitura e escrita) e `ReadOnly` (somente leitura).
`create_user`	Cria um usuário na conta (nome, e-mail e nível de acesso). Níveis aceitos: `Admin`, `Standard` ou `ReadOnly`. `Owner` é recusado: a posse só muda com `set_account_owner`.
`update_user`	Atualiza um usuário existente (nome, e-mail, nível de acesso; mesmos níveis de `create_user`).
`delete_user`	Remove um usuário da conta pelo e-mail.
`resend_verification_email`	Reenvia o e-mail de verificação a um usuário que ainda não verificou o endereço.

Servidores de rastreamento

Ferramenta	O que faz
`list_servers`	Lista todos os servidores de rastreamento de uma conta.
`get_server`	Obtém um servidor pelo domínio.
`upsert_server`	Cria ou atualiza um servidor de rastreamento pelo domínio (ex.: `go.acme.com`) e provisiona um certificado TLS para ele.
`delete_server`	Exclui um servidor pelo domínio.
`get_server_dns_config`	Informa os registros DNS a criar para apontar um domínio ao servidor de rastreamento: um registro A mais um AAAA, ou um único CNAME.
`check_server_dns`	Verifica se um domínio informado já aponta para o servidor, por registros A/AAAA ou por CNAME; indica se está pronto ou qual é o problema (nenhum registro, ou endereço errado, com o valor encontrado e o esperado).
`force_renew_server`	Força a renovação do certificado TLS de um servidor.

Regras de tag

Ferramenta	O que faz
`list_tag_rules`	Lista as regras de ativação da tag do navegador de um servidor (conta + domínio), com gatilho, capturas, se está ativa e datas. Inclui as desativadas; só as ativas são servidas ao navegador. Exige o recurso WebTracking na conta.
`create_tag_rule`	Cria uma regra que liga um gatilho a um nome de evento e às capturas (os parâmetros do evento). Falha se o nome já existir; para sobrescrever, use `upsert_tag_rule`. Limites: até 200 regras por servidor e 16 KiB por regra. Exige WebTracking.
`upsert_tag_rule`	Cria ou substitui uma regra pelo nome. A definição nova substitui a antiga inteira: mande todos os campos, não só os alterados. Exige WebTracking.
`delete_tag_rule`	Exclui uma regra pelo nome e informa quando a regra não existia. Exige WebTracking.

Pixels e destinos de conversão

Facebook (Conversions API):

Ferramenta	O que faz
`list_pixels`	Lista os pixels Facebook (CAPI) da conta.
`upsert_pixel`	Cria ou atualiza um pixel Facebook.
`delete_pixel`	Exclui um pixel Facebook pelo id do pixel.

GA4:

Ferramenta	O que faz
`list_measurement_ids`	Lista os measurement IDs GA4 da conta.
`upsert_measurement_id`	Cria ou atualiza um measurement ID GA4.
`delete_measurement_id`	Exclui um measurement ID GA4 pelo id.

TikTok:

Ferramenta	O que faz
`list_tiktok_pixels`	Lista os pixels TikTok da conta.
`upsert_tiktok_pixel`	Cria ou atualiza um pixel TikTok.
`delete_tiktok_pixel`	Exclui um pixel TikTok pelo pixel code.

Google Ads (ações de conversão):

Ferramenta	O que faz
`list_gads_conversion_actions`	Lista as ações de conversão de um customer do Google Ads (exige o customer_id numérico).
`upsert_gads_conversion_action`	Cria ou atualiza uma ação de conversão do Google Ads.
`delete_gads_conversion_action`	Exclui uma ação de conversão do Google Ads pelo id numérico.

Google Ads (clientes/customers):

Ferramenta	O que faz
`list_gads_customers`	Lista os customers (contas CAPI) do Google Ads.
`upsert_gads_customer`	Cria ou atualiza um customer do Google Ads.
`delete_gads_customer`	Exclui um customer do Google Ads pelo id numérico.

LinkedIn:

Ferramenta	O que faz
`list_linkedin_conversions`	Lista as conversões do LinkedIn da conta.
`upsert_linkedin_conversion`	Cria ou atualiza uma conversão do LinkedIn. O token de envio vem da conexão LinkedIn da conta: conecte o LinkedIn antes.
`delete_linkedin_conversion`	Exclui uma conversão do LinkedIn pela conversion URN.

Pinterest:

Ferramenta	O que faz
`list_pinterest_ad_accounts`	Lista as ad accounts do Pinterest da conta.
`upsert_pinterest_ad_account`	Cria ou atualiza uma ad account do Pinterest.
`delete_pinterest_ad_account`	Exclui uma ad account do Pinterest pelo id da ad account.

Conexões (OAuth)

Ferramenta	O que faz
`list_connections`	Lista os provedores conectáveis e se cada um está conectado para o usuário da conta.
`connection_status`	Status de conexão de um provedor para o usuário da conta.
`connect_service`	Inicia a conexão de um provedor; retorna a URL de consentimento que um humano precisa abrir e aprovar no navegador (link de uso único, expira em minutos).
`disconnect_service`	Desconecta um provedor para o usuário da conta.

Integrações (fontes de coleta)

Ferramenta	O que faz
`list_sources`	Lista as fontes (contas/propriedades) já ativadas para coleta em uma plataforma (google-ads, google-analytics, meta-ads); cada fonte traz o dono (e-mail e nome) que a conectou.
`activate_source`	Ativa uma conta de anúncios/propriedade como fonte de coleta. Age no escopo do usuário conectado (e não da conta, como as demais ferramentas de integração).
`list_available_accounts_tier1`	Lista as contas Tier 1 (gestoras: MCC, conta GA4, BM) disponíveis para ativar.
`list_available_accounts_tier2`	Lista as contas Tier 2 (filhas) sob uma Tier 1: as contas/propriedades que você ativa.
`list_meta_businesses`	Lista os Business Managers do Meta acessíveis (somente Meta).
`list_meta_business_accounts`	Lista as ad accounts sob um Business Manager do Meta (somente Meta).
`run_integration_onboarding`	Executa o onboarding de uma plataforma (atualiza contas disponíveis e configura coleta).
`run_integration_offboarding`	Desativa (ou expurga, com purge) contas ativadas em uma plataforma.
`list_integration_jobs`	Lista o log de jobs de coleta da conta (somente leitura): cada linha é uma tentativa de coleta de uma (provedor, fonte, data) com status, linhas coletadas e eventual erro. Mostra a atualidade dos dados ou diagnostica coletas que falharam. Filtros opcionais (provedor, fonte, status, período); retorna as 1000 linhas mais recentes.
`retry_integration_job`	Força um job de coleta que falhou a rodar de novo na hora, ignorando o backoff de 12h e o limite de retentativas; concede exatamente uma tentativa extra. Só jobs falhos são elegíveis (um job em execução, pendente ou já bem-sucedido é recusado). Recebe o `id` de uma linha de `list_integration_jobs`.

Smart links

Ferramenta	O que faz
`list_links`	Lista todos os smart links de uma conta.
`upsert_link`	Cria ou atualiza um smart link em um servidor de rastreamento (upsert pelo slug).
`delete_link`	Exclui um smart link de um servidor de rastreamento.
`link_stats`	Estatísticas de cliques e uso dos smart links, com filtro opcional por slugs e janela de tempo (since/until) com intervalo (step).
`link_qr`	Devolve a URL pública da imagem do QR code de um smart link (png ou svg); não devolve os bytes.

Relatórios e eventos

Ferramenta	O que faz
`list_reports`	Lista todos os relatórios definidos (o conjunto `dash.{plataforma}.{nome}`), cada um com seu `meta`: os parâmetros que exige (cada um com descrição, em ordem de bind) e as colunas de saída (cada uma com descrição, `type` e `semantics`: dimension/attribute/metric). É onde a IA descobre os parâmetros e o formato de saída antes de rodar.
`describe_report`	Roda o relatório e devolve os nomes das colunas mais uma única linha de amostra de dados reais (uma redução limit-1 de `get_report`), para obter uma amostra concreta. Para os nomes, tipos e semântica das colunas sem rodar, leia o `meta` de `list_reports`.
`get_report`	Busca um relatório nomeado da conta e reduz o CSV no serviço (filtro, agrupamento, agregação, ordenação, limite); retorna um resumo JSON, nunca linhas cruas.
`event_stats`	Estatísticas agregadas de eventos da conta, com filtro opcional por canais e janela de tempo (since/until) com intervalo (step).
`event_errors`	Consulta os erros de processamento de eventos da conta (CSV reduzido no serviço, resumo JSON). Colunas: channel, reference, happened_at, event_name, status_code, error_title, error_message, response, received, sent. A taxa de erros não é uma coluna: a IA a deriva combinando `event_stats` e `event_errors` (erros sobre o total de eventos).
`download_csv`	Gera uma URL de download do CSV completo (sem redução) de um endpoint TagServer, quando o chamador quer o arquivo inteiro em vez de um resumo.

Dashboards

Ferramenta	O que faz
`list_dashboards`	Lista os dashboards de uma conta (nome, posição, ETag).
`create_dashboard`	Cria um dashboard (nome único na conta).
`rename_dashboard`	Renomeia e/ou reordena um dashboard. Diferente das ferramentas de página e widget, não é guardada por If-Match: a última escrita vence, e uma edição concorrente pode ser sobrescrita.
`delete_dashboard`	Exclui um dashboard; cascateia para suas páginas e widgets (destrutivo).
`list_pages`	Lista as páginas de um dashboard, em ordem.
`get_page`	Obtém uma página: sua config de layout e seus widgets.
`create_page`	Cria uma página em um dashboard (nome único no dashboard).
`rename_page`	Renomeia, reordena ou move a página para outro dashboard.
`save_page`	Substitui a config de layout da página (fontes registradas, período fixado, filtro global, metadados de plataforma/BM).
`delete_page`	Exclui uma página; cascateia para seus widgets (destrutivo).
`list_widgets`	Lista os widgets de uma página.
`get_widget`	Obtém a config completa de um widget.
`add_widget`	Adiciona um widget a uma página (nome único na página; config opaca).
`update_widget`	Substitui a config de um widget.
`remove_widget`	Remove um widget de uma página pelo nome.
`add_data_source`	Registra uma fonte de dados na página (widgets vinculam-se a ela pelo id).
`remove_data_source`	Remove uma fonte de dados registrada na página pelo id.

Cobrança (billing)

Ferramenta	O que faz
`get_plans`	Lista os planos de cobrança disponíveis e seus preços.
`list_subscriptions`	Lista as assinaturas da conta (dono ou admin).
`get_subscription_invoices`	Lista as faturas de uma assinatura da conta (dono ou admin).
`cancel_subscription`	Cancela a assinatura ativa da conta (dono ou admin; cancelamento real).
`get_checkout`	Abre uma sessão de checkout Stripe para um plano (acesso `Standard` ou superior). Tem efeito real: cria a sessão e devolve um link de pagamento ativo, mas não cobra o cartão por si.

Dados da conta (chave-valor)

Ferramenta	O que faz
`list_account_kv_keys`	Lista as chaves do armazenamento chave-valor da conta.
`get_account_kv`	Obtém o valor JSON armazenado sob uma chave.
`put_account_kv`	Armazena um objeto JSON sob uma chave (upsert). O valor precisa ser um objeto JSON (pares chave/valor), não um número, texto ou lista soltos; a chave é texto livre e pode conter `/`.
`delete_account_kv`	Exclui o valor armazenado sob uma chave.

Busca: documentação e habilidades

Ferramenta	O que faz
`search_docs`	Busca semântica na documentação do TagServer por significado, em todos os corpora; cada resultado vem marcado com o corpus de origem. Não é escopada por conta. É o que a IA usa para responder "como configuro X" consultando esta documentação.
`list_skills`	Lista todas as habilidades (skills) disponíveis: o menu completo, cada uma com descrição curta e um `location`.
`search_skills`	Encontra uma habilidade por significado: um guia passo a passo para executar uma tarefa no TagServer.
`load_skill`	Carrega o texto completo de uma habilidade pelo seu `location` (de um resultado de `search_skills`).

Flowjutsu

Fluxos:

Ferramenta	O que faz
`list_flows`	Lista todos os fluxos da conta.
`get_flow`	Obtém um fluxo pelo nome.
`create_flow`	Cria um fluxo, podendo já iniciá-lo.
`patch_flow`	Altera um fluxo.
`delete_flow`	Exclui um fluxo pelo nome.
`start_flow`	Inicia um fluxo.
`stop_flow`	Para um fluxo.
`restart_flow`	Reinicia um fluxo.

Parâmetros:

Ferramenta	O que faz
`list_parameters`	Lista todos os parâmetros de fluxo da conta.
`get_parameter`	Obtém um parâmetro pelo nome (valores secretos são mascarados no servidor).
`create_parameter`	Cria um parâmetro.
`put_parameter`	Substitui um parâmetro pelo nome.
`patch_parameter`	Altera um parâmetro.
`delete_parameter`	Exclui um parâmetro pelo nome.

Templates (somente leitura via MCP):

Ferramenta	O que faz
`list_templates`	Lista todos os templates de fluxo.
`get_template`	Obtém um template pelo nome.

Projetos:

Ferramenta	O que faz
`list_projects`	Lista todos os projetos de fluxo da conta.
`get_project`	Obtém um projeto pelo nome.
`patch_project`	Altera um projeto.

Logs e uso:

Ferramenta	O que faz
`query_flow_logs`	Consulta os logs de execução de fluxos com filtros opcionais (tempo, fluxo, run, nó, tipo de evento).
`query_flow_usage`	Consulta o uso de fluxos com filtros opcionais (tempo, fluxo, limite).

Tabelas chave-valor:

Ferramenta	O que faz
`list_tables`	Lista todas as tabelas chave-valor da conta.
`create_table`	Cria uma tabela chave-valor.
`list_dropped_tables`	Lista tabelas removidas que ainda podem ser restauradas.
`drop_table`	Remove uma tabela (remoção reversível).
`patch_table`	Altera uma tabela.
`truncate_table`	Esvazia todas as linhas de uma tabela.
`undrop_table`	Restaura uma tabela removida.
`download_table_data`	Gera uma URL de download dos dados de uma tabela em NDJSON (um objeto JSON por linha).

Provisionamento:

Ferramenta	O que faz
`provision_plan`	Planeja um provisionamento a partir de um documento Provision; retorna um changeset sem aplicar.
`provision_apply`	Aplica um changeset de provisionamento.
`list_provisions`	Lista provisionamentos passados com filtros opcionais.

Execução avulsa:

Ferramenta	O que faz
`check_rhai`	Verifica (type-check) um script rhai sem executar.
`run_rhai`	Executa um script rhai e retorna o resultado.
`run_node`	Executa um nó de fluxo isolado (one-off), para testar sem montar um fluxo inteiro; recebe o nó como aparece num documento de fluxo.
`collect_sse`	Coleta um lote limitado de eventos de um endpoint SSE (text/event-stream) do TagServer.

Webhooks:

Ferramenta	O que faz
`list_webhooks`	Lista os webhooks de entrada ativos.
`send_inbound_webhook`	Entrega um webhook de entrada ao vivo a um fluxo (execução real, com efeitos colaterais); retorna a resposta crua do fluxo.

Nota

Esta lista corresponde ao servidor MCP atual. Após conectar, o próprio cliente de IA mostra as ferramentas disponíveis.

Veja também

Conectando uma IA (MCP): como configurar e autenticar o cliente.
Criação e gerenciamento de pixels: o guia prático de pixels e destinos.
Regras de tag: o conceito por trás das ferramentas de regras de tag.
Criando e gerenciando smart links: smart links via MCP.