MCP: Prospecting
Find companies and profiles with the treg.to balance and send the chosen ones to the funnel through the MCP. 3 tools. For Claude, Cursor and other MCP clients.
Tools in this area, generated from the server code. The descriptions come from that code, in Portuguese. To connect, see the XBASE MCP.
prospecting_balance
Saldo da conta treg.to do workspace (o mesmo do canto da tela Prospecção, em US$), o final do token conectado e o custo estimado de uma busca em cada fonte. A Prospecção paga as buscas com esse saldo; sem token conectado, conecte em XBASE → Contatos → Prospecção.
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional: precisa ser o workspace do token |
prospecting_import
Manda resultados de prospecting_search para uma etapa do funil, como o botão "Enviar para o funil" da tela: cria o contato e o card (ou reaproveita o que já existe, sem duplicar). Por padrão pula quem já está no CRM (skipExisting). Põe no card a tag de origem fonte:prospeccao-xbase e as tags pedidas (ex.: abordagem:diagnostico; criadas se não existirem) e, se informado, o responsável (userId de list-workspace-members). boardStageId vem de list-workspace-stages. Com inboxId ou connectionId (o número de list-whatsapp-connections), o card já nasce na caixa desse WhatsApp. Não envia mensagem: a abordagem é da automação do funil.
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional: precisa ser o workspace do token |
ids | yes | ids (ou placeIds) de prospecting_search |
boardStageId | yes | Etapa do funil de destino (list-workspace-stages) |
tags | no | Tags do card, ex.: ["abordagem:diagnostico"] |
responsibleUserId | no | Responsável pelo card (userId de list-workspace-members) |
skipExisting | no | Pula quem já está no CRM (padrão true) |
inboxId | no | Caixa de entrada do card (opcional): a conversa nasce nela, pronta para o WhatsApp |
connectionId | no | Ou o número (connectionId de list-whatsapp-connections): usa a caixa desse número |
prospecting_search
A busca da tela Prospecção, paga com o saldo do treg.to do workspace: google_maps (empresas no Google Maps), instagram (perfis pela bio), b2b_companies (empresas no LinkedIn) ou linkedin_people (pessoas pelo cargo). Até 20 resultados por busca (como a "Busca rápida"). Google Maps: ~US$ 0,002 a busca, sem e-mail e redes; com withEmail ou withInstagram a busca visita o site de cada empresa e custa ~US$ 0,10 (use só se precisar). Filtros: onlyWhatsapp (só com celular), hideInCrm (esconde quem já está no CRM), withSite/withoutSite, withInstagram, withEmail, minRating, minReviews, categories. Devolve os resultados (id, nome, whatsapp, fixo, site, e-mails, Instagram, endereço, nota, avaliações, categoria, placeId, alreadyInCrm) e o custo em US$. Use os ids em prospecting_import (ficam 6 h).
| Parameter | Required | Description |
|---|---|---|
workspaceId | no | Opcional: precisa ser o workspace do token |
source | no | google_maps (padrão) | instagram | b2b_companies | linkedin_people |
query | yes | Tema como se digita no Google Maps ("clínicas odontológicas"), palavra da bio ou cargo |
location | no | Cidade ou região ("Florianópolis, SC"); obrigatória no google_maps |
limit | no | Quantos resultados (1 a 20; padrão 20) |
onlyWhatsapp | no | Só quem tem celular (WhatsApp) |
hideInCrm | no | Esconde quem já está no CRM |
withSite | no | Só com site |
withoutSite | no | Só sem site |
withInstagram | no | Só com Instagram (no Google Maps visita os sites: ~US$ 0,10) |
withEmail | no | Só com e-mail (no Google Maps visita os sites: ~US$ 0,10) |
minRating | no | Nota mínima no Google (2 a 4.5) |
minReviews | no | Mínimo de avaliações |
categories | no | Categorias do Google ou setores (B2B) |