ContactsMCP

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.

ParameterRequiredDescription
workspaceIdnoOpcional: 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.

ParameterRequiredDescription
workspaceIdnoOpcional: precisa ser o workspace do token
idsyesids (ou placeIds) de prospecting_search
boardStageIdyesEtapa do funil de destino (list-workspace-stages)
tagsnoTags do card, ex.: ["abordagem:diagnostico"]
responsibleUserIdnoResponsável pelo card (userId de list-workspace-members)
skipExistingnoPula quem já está no CRM (padrão true)
inboxIdnoCaixa de entrada do card (opcional): a conversa nasce nela, pronta para o WhatsApp
connectionIdnoOu o número (connectionId de list-whatsapp-connections): usa a caixa desse número

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).

ParameterRequiredDescription
workspaceIdnoOpcional: precisa ser o workspace do token
sourcenogoogle_maps (padrão) | instagram | b2b_companies | linkedin_people
queryyesTema como se digita no Google Maps ("clínicas odontológicas"), palavra da bio ou cargo
locationnoCidade ou região ("Florianópolis, SC"); obrigatória no google_maps
limitnoQuantos resultados (1 a 20; padrão 20)
onlyWhatsappnoSó quem tem celular (WhatsApp)
hideInCrmnoEsconde quem já está no CRM
withSitenoSó com site
withoutSitenoSó sem site
withInstagramnoSó com Instagram (no Google Maps visita os sites: ~US$ 0,10)
withEmailnoSó com e-mail (no Google Maps visita os sites: ~US$ 0,10)
minRatingnoNota mínima no Google (2 a 4.5)
minReviewsnoMínimo de avaliações
categoriesnoCategorias do Google ou setores (B2B)

On this page