À la fin de ce guide, votre agent IA (Claude, ChatGPT, Cursor, Grok ou tout ce qui parle MCP ou HTTP) recherchera parmi 630.7 millions de contacts, décomptera des marchés gratuitement et exportera seul des e-mails vérifiés. Nous allons parcourir tout le chemin une fois, lentement, chaque embranchement étant balisé : ce que vous verrez quand ça fonctionne, et ce que cela signifie quand ça ne fonctionne pas.
Ce qu'il vous faut avant de commencer
Commencez avec une adresse e-mail que vous pouvez confirmer et un environnement d'agent pris en charge. L'abonnement n'est pas le seul mode de facturation ; les actions autorisées peuvent utiliser un portefeuille prépayé.
Les nouveaux comptes reçoivent un essai de 7 jours après confirmation de l'e-mail : 100 crédits et 300 e-mails de campagne, sans abonnement automatique ; à la fin de l'essai, les campagnes se mettent en pause et les crédits d'essai non utilisés expirent jusqu'à l'ajout d'un forfait ou de crédits à l'usage. L'app, l'API REST, la CLI et MCP partagent le même compte et le même solde ; connecter un autre client ou créer une clé API n'ajoute pas de second crédit d'essai. Les soldes et abonnements existants ne changent pas.
Utilisez la connexion MCP OAuth quand votre client prend en charge les serveurs MCP distants personnalisés. Sinon, utilisez la CLI depuis un terminal avec Node/npm, ou REST depuis un environnement HTTP autorisé. Coller une clé personnelle dans une conversation ne crée pas de connexion et ne contourne pas les restrictions du client.
La recherche, les décomptes et les aperçus masqués ne déduisent aucun crédit. Les autorisations du compte et les limites de débit s'appliquent toujours.
Exigez une approbation explicite du périmètre, de la limite de lignes et du budget de crédits avant tout déblocage, enrichissement de personnes ou nouvel export, et avant de lancer une campagne ou d'envoyer une réponse. Les libellés des outils clients ne garantissent pas une confirmation universelle ; les commandes CLI non interactives peuvent dépenser immédiatement.
Étape 1 : créez le compte par la voie agent
Ouvrez app.argorant.com/start. Vous verrez deux portes : l'une pour travailler dans l'app, l'autre pour configurer un agent. Choisissez le côté agent.
Inscrivez-vous avec une boîte mail permanente et confirmez l'adresse avec le code reçu. Deux embranchements ici :
- « Les crédits de départ exigent une adresse e-mail permanente. » Vous avez utilisé un domaine d'adresse jetable. Utilisez plutôt une boîte professionnelle ou personnelle ; les boîtes temporaires ne donnent jamais droit aux crédits gratuits.
- L'e-mail de confirmation n'arrive jamais. Vérifiez d'abord les spams, puis demandez un nouveau code depuis le même écran. Les codes expirent, et seul le plus récent compte.
Étape 2 : choisissez OAuth ou créez une clé API personnelle
Pour le MCP distant, connectez-vous avec OAuth et votre compte Argorant ; ne collez pas de clé personnelle dans l'URL MCP. Pour la CLI ou l'API REST, créez une clé personnelle dans /start ou Profil. Une première clé éligible peut recevoir la dotation de départ décrite plus haut. Vérifiez le solde renvoyé par le compte avant de promettre un résultat gratuit.
La clé commence par ag_live_ et n'est affichée en entier qu'une seule fois. Conservez-la comme un mot de passe. Si vous la perdez, révoquez-la et créez-en une nouvelle ; rien d'autre ne change sur le compte.
Si la création de la clé est refusée avec « Les crédits de départ ont déjà été utilisés pour cette boîte mail », la dotation gratuite a déjà été utilisée par un compte sur la même adresse normalisée (les suffixes plus et les points Gmail ne créent pas de nouvelles boîtes). Rechargez le portefeuille ou choisissez un forfait ; la clé est créée sans problème dans les deux cas.
Étape 3 : branchez votre agent
Deux modes de transport ; choisissez celui que votre agent prend en charge.
Option A : MCP (Claude, ChatGPT, Cursor, Grok Bot)
Ajoutez https://mcp.argorant.com/mcp dans un client qui prend en charge le MCP distant et OAuth. Connectez-vous et approuvez les autorisations demandées. Le catalogue actuel compte 104 outils pour trouver des personnes, des contacts et des numéros de téléphone, gérer listes et exports, vérifier vos propres listes d'e-mails, piloter campagnes, réponses, boîtes mail et crédits. Fixez des règles explicites de dépense et de résultat avant de commencer.
Option B : REST avec une clé personnelle dans un environnement HTTP autorisé
Chaque endpoint se trouve sous https://app.argorant.com/api/mcp/ avec Authorization: Bearer ag_live_.... Les trois que vous utiliserez en permanence :
Étape 4 : la première vraie tâche
Donnez à l'agent quelque chose de concret : « Comptez les CFO des fintechs allemandes sur Argorant, montrez-moi un échantillon et dites-moi ce que coûterait un export des 500 premiers. »
Une exécution saine renvoie le décompte réel, y compris zéro si aucune fiche ne correspond, un aperçu masqué et le coût en crédits applicable. Un décompte de contacts n'est ni un décompte d'entreprises uniques ni la preuve que chaque e-mail est déjà vérifié. À ce stade, les coordonnées restent masquées par conception : initiales, rôle, entreprise, localisation, mais pas d'adresse. Ce n'est pas un bug ; c'est pour cela qu'explorer ne coûte rien.
Étape 5 : l'export, et ce que coûte vraiment la facture
Quand la liste vous semble bonne, laissez l'agent exporter. Maintenant, et seulement maintenant, les crédits bougent : 1 crédit par contact délivrable. La vérification a lieu en direct au moment de l'export ; les adresses qui échouent sont retirées et ne coûtent rien. Un export de 500 lignes dont 460 adresses passent la vérification facture 460 crédits, et le CSV téléchargé contient 460 lignes délivrables quelques minutes plus tôt.
Les embranchements que vous pourriez rencontrer :
- 402, « L'accès API et MCP nécessite un forfait ou des crédits de portefeuille. » Les crédits de départ sont épuisés. Rechargez le portefeuille (500 crédits pour $17.50 ; sans abonnement) ou choisissez un forfait. Le portefeuille est la voie native des agents : de l'argent entre, des leads sortent, rien de récurrent.
- 429, limite de débit. L'agent martèle l'API. Les niveaux portefeuille et forfait relèvent le plafond ; un agent bien conçu regroupe les décomptes au lieu de boucler un filtre à la fois.
- Export plus petit que le décompte. Comportement normal : le décompte correspond à l'univers des correspondances, l'export au sous-ensemble délivrable après vérification en direct et après retrait des lignes déjà exportées.
La suite
Votre agent est connecté et a produit sa première liste vérifiée. Le guide suivant enseigne ce qui produit vraiment des effets cumulés : construire une liste cible précise avec les filtres de secteur, de niveau hiérarchique et de mots-clés, et laisser l'agent élargir ou resserrer le marché sur commande.
