Ao fim deste guia, o seu agente de IA (Claude, ChatGPT, Cursor, Grok ou qualquer coisa que fale MCP ou HTTP) vai buscar entre 630.7 milhões de contatos, contar mercados de graça e exportar e-mails verificados sozinho. Vamos fazer o caminho inteiro uma vez, com calma, com cada desvio sinalizado: o que você vai ver quando der certo e o que significa quando não der.
O que você precisa antes de começar
Comece com um endereço de e-mail que você consiga confirmar e um ambiente de agente compatível. A assinatura não é a única forma de cobrança; ações permitidas podem usar um saldo pré-pago.
Contas novas ganham um teste de 7 dias após confirmar o e-mail: 100 créditos e 300 e-mails de campanha, sem assinatura automática; quando ele termina, as campanhas pausam e os créditos de teste não usados expiram até que um plano ou créditos avulsos sejam adicionados. O app, a API REST, a CLI e o MCP compartilham a mesma conta e o mesmo saldo; conectar outro cliente ou criar uma chave de API não dá um segundo bônus. Saldos e assinaturas existentes não mudam.
Use a conexão MCP com OAuth quando seu cliente aceitar servidores MCP remotos personalizados. Se não, use a CLI num terminal com Node/npm, ou REST num ambiente HTTP autorizado. Colar uma chave pessoal num chat não cria uma conexão nem contorna as restrições do cliente.
Busca, contagens e prévias mascaradas não descontam créditos. As permissões da conta e os limites de requisições continuam valendo.
Exija aprovação explícita do escopo, do limite de linhas e do orçamento de créditos antes de revelar, enriquecer pessoas ou criar uma nova exportação, e antes de iniciar uma campanha ou enviar uma resposta. Os rótulos das ferramentas do cliente não são uma garantia universal de confirmação; comandos de CLI não interativos podem gastar na hora.
Passo 1: crie a conta pelo caminho do agente
Abra app.argorant.com/start. Você vai ver duas portas: uma para trabalhar no app e outra para configurar um agente. Escolha o lado do agente.
Cadastre-se com uma caixa de e-mail permanente e confirme o endereço com o código que chega na sua caixa de entrada. Aqui há dois desvios:
- "Os créditos iniciais exigem um endereço de e-mail permanente." Você usou um domínio de e-mail descartável. Use uma caixa corporativa ou pessoal; caixas temporárias nunca dão direito aos créditos grátis.
- O e-mail de confirmação nunca chega. Confira primeiro o spam e depois peça um código novo na mesma tela. Os códigos expiram, e só o mais recente vale.
Passo 2: escolha OAuth ou crie uma chave de API pessoal
Para o MCP remoto, conecte com OAuth e a sua conta do Argorant; não cole uma chave pessoal na URL do MCP. Para a CLI ou a API REST, crie uma chave pessoal em /start ou em Perfil. Uma primeira chave elegível pode receber o crédito inicial descrito acima. Confira o saldo da conta retornado antes de prometer resultados grátis.
A chave começa com ag_live_ e aparece completa exatamente uma vez. Guarde-a como uma senha. Se você perdê-la, revogue e gere uma nova; nada mais muda na conta.
Se a criação da chave for recusada com "Os créditos iniciais já foram resgatados para esta caixa de e-mail", o crédito grátis já foi usado por uma conta com o mesmo endereço normalizado (tags com + e pontos do Gmail não criam caixas novas). Recarregue o saldo ou escolha um plano; a chave é criada normalmente nos dois casos.
Passo 3: conecte o seu agente
Duas opções de transporte; escolha a que o seu agente suporta.
Opção A: MCP (Claude, ChatGPT, Cursor, Grok Bot)
Adicione https://mcp.argorant.com/mcp num cliente compatível com MCP remoto e OAuth. Entre e aprove as permissões solicitadas. O catálogo atual tem 104 ferramentas para encontrar pessoas, contatos e números de telefone, listas e exportações, verificações das suas próprias listas de e-mails, campanhas, respostas, caixas de e-mail e créditos. Defina as regras explícitas de gasto e de resultado antes de começar.
Opção B: REST com uma chave pessoal num ambiente HTTP autorizado
Todos os endpoints ficam em https://app.argorant.com/api/mcp/ com Authorization: Bearer ag_live_.... Os três que você vai usar o tempo todo:
Passo 4: a primeira tarefa real
Dê ao agente algo concreto: "Conte os CFOs de fintechs alemãs no Argorant, me mostre uma amostra e diga quanto custaria exportar os 500 primeiros."
Uma execução saudável retorna a contagem real, inclusive zero se nenhum registro corresponder, uma prévia mascarada e o custo em créditos aplicável. Uma contagem de contatos não é uma contagem de empresas únicas nem prova de que todos os e-mails já estão verificados. Nesta etapa, os dados de contato ficam mascarados de propósito: iniciais, cargo, empresa e localização, mas nenhum endereço. Não é um bug; é o motivo de explorar não custar nada.
Passo 5: exporte, e o que você realmente paga
Quando a lista parecer certa, deixe o agente exportar. Agora, e só agora, os créditos se movem: 1 crédito por contato entregável. A verificação roda ao vivo no momento da exportação; endereços que falham são removidos e não custam nada. Uma exportação de 500 linhas em que 460 endereços passam na verificação cobra 460 créditos, e o CSV que você baixa tem 460 linhas que eram entregáveis minutos antes.
Os desvios que você pode encontrar:
- 402, "O acesso à API e ao MCP exige um plano ou créditos no saldo." Os créditos iniciais acabaram. Recarregue o saldo (500 créditos por $17.50, sem assinatura) ou escolha um plano. O saldo é o caminho nativo para agentes: entra dinheiro, saem leads, nada recorrente.
- 429, limite de requisições. O agente está martelando a API. Os níveis de saldo e de plano aumentam o teto; um agente bem construído agrupa as contagens em vez de rodar um filtro de cada vez em loop.
- Exportação menor que a contagem. É o comportamento correto: a contagem é o universo correspondente, e a exportação é o subconjunto entregável depois da verificação ao vivo e depois de remover as linhas que você já exportou antes.
Para onde ir agora
O seu agente está conectado e produziu a primeira lista verificada. O próximo guia ensina a parte que realmente rende com o tempo: montar uma lista-alvo precisa com filtros de setor, senioridade e palavras-chave, e deixar o agente ampliar ou estreitar o mercado sob comando.
