MCP Server

Le Model Context Protocol (MCP) est un protocole ouvert d'Anthropic qui permet aux modèles IA d'interagir de manière sécurisée avec des outils et sources de données externes. BillionVerify fournit des capacités de vérification d'e-mail de niveau entreprise pour les agents IA via HTTP Streamable Transport, rendant l'intégration incroyablement simple.

Pourquoi les agents IA ont besoin de vérification d'e-mail

Les cas d'utilisation modernes des agents IA incluent :

• Claude Code doit vérifier les adresses e-mail lors du traitement des données utilisateur
• OpenCode nécessite une validation d'e-mail dans les workflows automatisés
• Gemini CLI les agents ont besoin d'assurance qualité lors du traitement des données d'inscription
• Codex le code généré nécessite une logique de vérification d'e-mail intégrée
• Agents IA personnalisés doivent confirmer l'authenticité des contacts lors des interactions avec les humains

BillionVerify MCP permet à tout agent IA d'appeler directement des services de vérification d'e-mail de niveau entreprise via la norme HTTP Streamable Transport - aucune configuration complexe requise.

Fonctionnalités principales

1. Vérification d'e-mail unique en temps réel

• Vérifier le format de l'e-mail, le domaine et les enregistrements MX
• Vérification de connexion SMTP optionnelle
• Détection d'e-mail jetable
• Identification e-mail professionnel vs gratuit
• Détection d'e-mail de rôle (support@, noreply@, etc.)
• Temps de réponse moyen < 2 secondes

2. Vérification d'e-mails en lot

• Vérifier jusqu'à 50 e-mails à la fois
• Traitement concurrent pour l'efficacité
• Résultats détaillés et statistiques

3. Système de cache intelligent

• E-mails valides mis en cache pendant 7 jours
• E-mails invalides mis en cache pendant 7 jours
• Statut inconnu mis en cache pendant 10 minutes
• Réduit les vérifications répétées inutiles

4. Facturation précise des crédits

• E-mail valide : 1 crédit
• E-mail invalide : 0 crédit (évite le gaspillage)
• Statut inconnu : 0 crédit (réessai automatique)
• Requêtes de solde en temps réel

Clients IA supportés

Configuration rapide (Transport HTTP - Recommandé)

La façon la plus simple d'intégrer - aucun package npm à installer !

Étape 1 : Obtenir une clé API

Visitez le tableau de bord BillionVerify pour créer votre clé API.

Étape 2 : Configurer Claude Desktop

Modifiez le fichier de configuration :

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json

Windows : %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "billionverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"]
    }
  }
}

Remplacez YOUR_API_KEY par votre clé API réelle, puis redémarrez Claude Desktop.

C'est tout ! Pas de npm install, pas de dépendances. curl est préinstallé sur tous les systèmes. Claude a maintenant des capacités de vérification d'e-mail.

Étape 3 : Commencer à vérifier

Dans votre conversation, demandez simplement :

Veuillez vérifier cet e-mail : user@example.com

Claude appellera automatiquement BillionVerify et retournera des résultats détaillés.

Configuration de Claude Code

Pour Claude Code CLI, ajoutez le serveur MCP :

claude mcp add billionverify -- curl --stdio "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"

Ou ajoutez à votre ~/.claude.json :

{
  "mcpServers": {
    "billionverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"]
    }
  }
}

Configuration d'OpenCode

Pour OpenCode, configurez dans votre ~/.opencode/config.json :

{
  "mcpServers": {
    "billionverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"]
    }
  }
}

Configuration de Gemini CLI

Pour Gemini CLI, ajoutez à votre configuration :

{
  "mcpServers": {
    "billionverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"]
    }
  }
}

Configuration de Cursor

Dans Cursor, allez dans Paramètres > MCP et ajoutez :

{
  "billionverify": {
    "command": "curl",
    "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"]
  }
}

Méthode NPX (Alternative)

Si vous préférez l'approche avec le package npm :

{
  "mcpServers": {
    "billionverify": {
      "command": "npx",
      "args": ["-y", "@billionverify/mcp-server"],
      "env": {
        "BV_API_KEY": "your-api-key-here"
      }
    }
  }
}

Outils disponibles

verify_single_email

Vérifie une adresse e-mail unique avec validation complète.

Paramètres :

Retourne :

{
  "email": "user@example.com",
  "status": "valid",
  "score": 1,
  "is_deliverable": true,
  "is_disposable": false,
  "is_catchall": false,
  "is_role": false,
  "is_free": true,
  "domain": "example.com",
  "mx_records": ["has_mx_records"],
  "smtp_check": true,
  "response_time": 2,
  "credits_used": 1
}

Exemple d'utilisation dans Claude :

"Vérifie si test@example.com est un e-mail valide"

verify_batch_emails

Vérifie plusieurs adresses e-mail à la fois (max 50).

Paramètres :

Retourne :

{
  "total_emails": 2,
  "valid_emails": 2,
  "invalid_emails": 0,
  "results": [...],
  "credits_used": 2,
  "process_time": 4
}

Exemple d'utilisation dans Claude :

"Vérifie ces e-mails : user1@example.com, user2@test.com, info@company.com"

get_account_balance

Vérifie les crédits du compte et les statistiques d'utilisation.

Paramètres : Aucun

Retourne :

{
  "account_id": "acc_xxx",
  "credits_balance": 842740,
  "credits_consumed": 157260,
  "credits_added": 1000000,
  "last_updated": "2026-02-05T04:51:35Z"
}

Exemple d'utilisation dans Claude :

"Combien de crédits de vérification me reste-t-il ?"

health_check

Vérifie l'état de santé du serveur MCP.

Paramètres : Aucun

Retourne :

{
  "status": "healthy",
  "version": "2.1.0",
  "service": "billionverify-mcp",
  "mode": "api-proxy"
}

get_task_status

Interroge la progression d'une tâche de vérification de fichier.

Paramètres :

Retourne :

{
  "job_id": "job-uuid-xxxxx",
  "status": "completed",
  "progress": 100,
  "total_emails": 1000,
  "processed_emails": 1000,
  "valid_count": 850,
  "invalid_count": 100
}

Exemple d'utilisation dans Claude :

"Quel est le statut de ma tâche de vérification de fichier job-123 ?"

get_download_url

Obtient le lien de téléchargement des résultats de vérification avec des filtres de statut optionnels.

Paramètres :

Exemple d'utilisation dans Claude :

"Obtiens le lien de téléchargement pour uniquement les e-mails valides de job-123"

create_webhook

Crée un webhook pour recevoir des notifications de fin de vérification.

Paramètres :

Retourne :

{
  "id": "webhook-uuid",
  "url": "https://your-server.com/webhook",
  "events": ["file.completed"],
  "secret": "hmac-secret-for-signature",
  "is_active": true
}

Remarque : Le secret n'est retourné qu'une seule fois à la création. Conservez-le pour la vérification de signature.

Exemple d'utilisation dans Claude :

"Crée un webhook pour me notifier quand la vérification de fichier est terminée"

list_webhooks

Liste tous les webhooks pour le compte actuel.

Paramètres : Aucun

Retourne :

{
  "total": 1,
  "webhooks": [
    {
      "id": "webhook-uuid",
      "url": "https://your-server.com/webhook",
      "events": ["file.completed"],
      "is_active": true
    }
  ]
}

Exemple d'utilisation dans Claude :

"Montre-moi tous mes webhooks configurés"

delete_webhook

Supprime un webhook spécifique.

Paramètres :

Exemple d'utilisation dans Claude :

"Supprime le webhook avec l'ID webhook-123"

Exemples d'utilisation

Vérification de base

Utilisateur :

Vérifie john@google.com

Claude :

Je vais vérifier cette adresse e-mail pour vous.

Résultat de vérification d'e-mail

Champ	Valeur
E-mail	john@google.com
Statut	Valide
Délivrable	Oui
Jetable	Non
Score	0.95

Cet e-mail semble être valide et délivrable.

Vérification de plusieurs e-mails

Utilisateur :

Vérifie ces e-mails : john@google.com, test@mailinator.com, support@microsoft.com

Claude :

Je vais vérifier les trois adresses e-mail.

E-mail	Statut	Notes
john@google.com	Valide	Délivrable, e-mail professionnel
test@mailinator.com	Invalide	E-mail jetable, rejet recommandé
support@microsoft.com	Valide	Adresse de rôle, peut être partagée

Recommandations :

• john@google.com - Sûr à utiliser
• test@mailinator.com - E-mail temporaire, non recommandé
• support@microsoft.com - Valide mais probablement une boîte d'équipe

Workflow développeur

Utilisateur (dans Claude Code) :

Vérifie les e-mails de test dans mon fichier .env.example

Claude :

Je vais lire le fichier et vérifier toutes les adresses e-mail trouvées.

Trouvé 3 adresses e-mail dans .env.example :

• TEST_EMAIL=user@example.com
• ADMIN_EMAIL=admin@company.com
• SUPPORT_EMAIL=help@temp-mail.org

Résultats de vérification :

E-mail	Statut
user@example.com	Inconnu (domaine exemple)
admin@company.com	Valide
help@temp-mail.org	Invalide (jetable)

Envisagez d'utiliser de vraies adresses e-mail pour les tests.

Format de sortie

Le serveur MCP retourne des résultats bien formatés :

## Résultat de vérification d'e-mail

**E-mail :** test@example.com
**Statut :** VALIDE
**Score de confiance :** 95.0%

### Détails
| Vérification | Résultat |
|--------------|----------|
| Délivrable | Oui |
| Format valide | Oui |
| Domaine valide | Oui |
| MX valide | Oui |
| Jetable | Non |
| Adresse de rôle | Non |
| Catch-all | Non |
| Fournisseur gratuit | Non |

**Crédits utilisés :** 1

Bonnes pratiques

1. Stocker la clé API en toute sécurité

Ne codez jamais en dur votre clé API. Utilisez des variables d'environnement :

{
  "env": {
    "BV_API_KEY": "${BV_API_KEY}"
  }
}

2. Utiliser le langage naturel

Le serveur MCP comprend diverses formulations :

• "Vérifie user@example.com"
• "Est-ce que test@company.com est un e-mail valide ?"
• "Vérifie si cet e-mail est délivrable : john@test.com"
• "Peux-tu valider ces adresses e-mail pour moi ?"

3. Traiter par lots si possible

Pour plusieurs e-mails, demandez à Claude de les vérifier ensemble pour plus d'efficacité :

"Vérifie tous ces e-mails en une fois : email1@test.com, email2@test.com, email3@test.com"

Dépannage

Serveur MCP introuvable

Si Claude dit qu'il ne peut pas trouver l'outil BillionVerify :

1. Vérifiez le chemin de votre fichier de configuration
2. Assurez-vous que le JSON est valide
3. Redémarrez complètement Claude Desktop
4. Vérifiez que votre clé API est correcte

Erreurs de limite de débit

Si vous voyez des erreurs de limite de débit :

1. Vérifiez vos crédits restants avec "Combien de crédits me reste-t-il ?"
2. Attendez un moment et réessayez
3. Envisagez de mettre à niveau votre plan pour des limites plus élevées

Problèmes de connexion

Si la vérification échoue :

1. Vérifiez votre connexion Internet
2. Vérifiez que votre clé API est valide
3. Essayez d'abord une vérification simple

FAQ

Ma clé API est-elle sécurisée ?

Oui. La clé API est stockée dans votre fichier de configuration local et utilisée uniquement par le serveur MCP fonctionnant sur votre machine. Elle n'est jamais envoyée à des tiers.

Quels clients IA supportent MCP ?

Tout client compatible MCP fonctionne, y compris Claude Desktop, Claude Code, Cursor, Zed, Cline et Continue.

Que se passe-t-il hors ligne ?

Si l'API BillionVerify est inaccessible, l'outil retourne un message d'erreur. Cela n'affecte pas les autres capacités de Claude.

Comment fonctionnent les crédits ?

Chaque vérification d'e-mail utilise 1 crédit. Les vérifications en masse utilisent 1 crédit par e-mail. Vérifiez votre solde avec l'outil check_credits.

Prochaines étapes