ContatosMCP

MCP: Prospecção

Buscar empresas e perfis com o saldo do treg.to e mandar os escolhidos para o funil pelo MCP. 3 ferramentas. Para o Claude, o Cursor e outros clientes MCP.

Ferramentas desta área, geradas do código do servidor. As descrições vêm desse código, em português. Para conectar, veja o MCP da XBASE.

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.

ParâmetroObrigatórioDescrição
workspaceIdnãoOpcional: 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.

ParâmetroObrigatórioDescrição
workspaceIdnãoOpcional: precisa ser o workspace do token
idssimids (ou placeIds) de prospecting_search
boardStageIdsimEtapa do funil de destino (list-workspace-stages)
tagsnãoTags do card, ex.: ["abordagem:diagnostico"]
responsibleUserIdnãoResponsável pelo card (userId de list-workspace-members)
skipExistingnãoPula quem já está no CRM (padrão true)
inboxIdnãoCaixa de entrada do card (opcional): a conversa nasce nela, pronta para o WhatsApp
connectionIdnãoOu 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).

ParâmetroObrigatórioDescrição
workspaceIdnãoOpcional: precisa ser o workspace do token
sourcenãogoogle_maps (padrão) | instagram | b2b_companies | linkedin_people
querysimTema como se digita no Google Maps ("clínicas odontológicas"), palavra da bio ou cargo
locationnãoCidade ou região ("Florianópolis, SC"); obrigatória no google_maps
limitnãoQuantos resultados (1 a 20; padrão 20)
onlyWhatsappnãoSó quem tem celular (WhatsApp)
hideInCrmnãoEsconde quem já está no CRM
withSitenãoSó com site
withoutSitenãoSó sem site
withInstagramnãoSó com Instagram (no Google Maps visita os sites: ~US$ 0,10)
withEmailnãoSó com e-mail (no Google Maps visita os sites: ~US$ 0,10)
minRatingnãoNota mínima no Google (2 a 4.5)
minReviewsnãoMínimo de avaliações
categoriesnãoCategorias do Google ou setores (B2B)

Nesta página