MCP Server

Model Context Protocol (MCP) is een open protocol van Anthropic dat AI-modellen in staat stelt veilig te communiceren met externe tools en gegevensbronnen. BillionVerify biedt e-mailverificatie van enterprise-niveau voor AI-agenten via HTTP Streamable Transport, waardoor integratie ongelooflijk eenvoudig wordt.

Waarom AI-agenten E-mailverificatie Nodig Hebben

Moderne AI-agent use cases omvatten:

• Claude Code moet e-mailadressen verifiëren bij het verwerken van gebruikersgegevens
• OpenCode vereist e-mailvalidatie in geautomatiseerde workflows
• Gemini CLI agenten hebben kwaliteitsborging nodig bij het verwerken van registratiegegevens
• Codex gegenereerde code heeft ingebouwde e-mailverificatielogica nodig
• Aangepaste AI-agenten moeten contactauthenticiteit bevestigen bij interactie met mensen

BillionVerify MCP stelt elke AI-agent in staat om direct enterprise-niveau e-mailverificatiediensten aan te roepen via de HTTP Streamable Transport standaard - geen complexe configuratie vereist.

Kernfuncties

1. Realtime Verificatie van Enkele E-mail

• Verifieer e-mailformaat, domein en MX-records
• Optionele SMTP-verbindingscontrole
• Detectie van wegwerp-e-mails
• Identificatie van bedrijfs- vs gratis e-mail
• Detectie van rol-gebaseerde e-mail (support@, noreply@, etc.)
• Gemiddelde responstijd < 2 seconden

2. Batch E-mailverificatie

• Verifieer tot 50 e-mails tegelijk
• Gelijktijdige verwerking voor efficiëntie
• Gedetailleerde resultaten en statistieken

3. Slim Cachingsysteem

• Geldige e-mails gecacht voor 7 dagen
• Ongeldige e-mails gecacht voor 7 dagen
• Onbekende status gecacht voor 10 minuten
• Vermindert onnodige herhaalde verificaties

4. Nauwkeurige Creditfacturering

• Geldig e-mail: 1 credit
• Ongeldig e-mail: 0 credits (voorkomt verspilling)
• Onbekende status: 0 credits (automatisch opnieuw)
• Realtime saldo-opvragen

Ondersteunde AI-clients

Snelle Setup (HTTP Transport - Aanbevolen)

De eenvoudigste manier om te integreren - geen npm-pakketten te installeren!

Stap 1: Verkrijg API-sleutel

Bezoek het BillionVerify Dashboard om uw API-sleutel aan te maken.

Stap 2: Configureer Claude Desktop

Bewerk het configuratiebestand:

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"]
    }
  }
}

Vervang YOUR_API_KEY door uw werkelijke API-sleutel, herstart dan Claude Desktop.

Dat is alles! Geen npm install, geen afhankelijkheden. curl is voorgeïnstalleerd op alle systemen. Claude heeft nu e-mailverificatiemogelijkheden.

Stap 3: Begin met Verifiëren

In uw gesprek, vraag gewoon:

Verifieer alstublieft dit e-mailadres: user@example.com

Claude zal automatisch BillionVerify aanroepen en gedetailleerde resultaten retourneren.

Claude Code Setup

Voor Claude Code CLI, voeg de MCP-server toe:

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

Of voeg toe aan uw ~/.claude.json:

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

OpenCode Setup

Voor OpenCode, configureer in uw ~/.opencode/config.json:

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

Gemini CLI Setup

Voor Gemini CLI, voeg toe aan uw configuratie:

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

Cursor Setup

In Cursor, ga naar Settings > MCP en voeg toe:

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

NPX Methode (Alternatief)

Als u de npm-pakket aanpak prefereert:

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

Beschikbare Tools

verify_single_email

Verifieer een enkel e-mailadres met uitgebreide validatie.

Parameters:

Retourneert:

{
  "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
}

Voorbeeldgebruik in Claude:

"Controleer of test@example.com een geldig e-mailadres is"

verify_batch_emails

Verifieer meerdere e-mailadressen tegelijk (max 50).

Parameters:

Retourneert:

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

Voorbeeldgebruik in Claude:

"Verifieer deze e-mails: user1@example.com, user2@test.com, info@company.com"

get_account_balance

Controleer accountcredits en gebruiksstatistieken.

Parameters: Geen

Retourneert:

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

Voorbeeldgebruik in Claude:

"Hoeveel verificatiecredits heb ik nog over?"

health_check

Controleer MCP-server gezondheidsstatus.

Parameters: Geen

Retourneert:

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

get_task_status

Vraag bestandsverificatietaak voortgang op.

Parameters:

Retourneert:

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

Voorbeeldgebruik in Claude:

"Wat is de status van mijn bestandsverificatietaak job-123?"

get_download_url

Verkrijg download-link voor verificatieresultaten met optionele statusfilters.

Parameters:

Voorbeeldgebruik in Claude:

"Verkrijg download-link voor alleen geldige e-mails van job-123"

create_webhook

Maak een webhook aan om verificatie-voltooiingsmeldingen te ontvangen.

Parameters:

Retourneert:

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

Opmerking: Het secret wordt slechts eenmaal geretourneerd bij aanmaak. Bewaar het voor handtekeningverificatie.

Voorbeeldgebruik in Claude:

"Maak een webhook aan om me te notificeren wanneer bestandsverificatie voltooid is"

list_webhooks

Lijst alle webhooks voor de huidige account.

Parameters: Geen

Retourneert:

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

Voorbeeldgebruik in Claude:

"Toon me al mijn geconfigureerde webhooks"

delete_webhook

Verwijder een specifieke webhook.

Parameters:

Voorbeeldgebruik in Claude:

"Verwijder de webhook met ID webhook-123"

Gebruiksvoorbeelden

Basis Verificatie

Gebruiker:

Verifieer john@google.com

Claude:

Ik zal dat e-mailadres voor u verifiëren.

E-mailverificatieresultaat

Veld	Waarde
E-mail	john@google.com
Status	Geldig
Afleverbaar	Ja
Wegwerp	Nee
Score	0.95

Deze e-mail lijkt geldig en afleverbaar te zijn.

Meerdere E-mailverificatie

Gebruiker:

Controleer deze e-mails: john@google.com, test@mailinator.com, support@microsoft.com

Claude:

Ik zal alle drie de e-mailadressen verifiëren.

E-mail	Status	Opmerkingen
john@google.com	Geldig	Afleverbaar, zakelijke e-mail
test@mailinator.com	Ongeldig	Wegwerp-e-mail, aanbevolen te weigeren
support@microsoft.com	Geldig	Rol-gebaseerd adres, kan gedeeld zijn

Aanbevelingen:

• john@google.com - Veilig om te gebruiken
• test@mailinator.com - Tijdelijke e-mail, niet aanbevolen
• support@microsoft.com - Geldig maar waarschijnlijk een team-inbox

Ontwikkelaarsworkflow

Gebruiker (in Claude Code):

Verifieer de test-e-mails in mijn .env.example bestand

Claude:

Ik zal het bestand lezen en alle gevonden e-mailadressen verifiëren.

3 e-mailadressen gevonden in .env.example:

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

Verificatieresultaten:

E-mail	Status
user@example.com	Onbekend (voorbeeld domein)
admin@company.com	Geldig
help@temp-mail.org	Ongeldig (wegwerp)

Overweeg echte e-mailadressen te gebruiken voor testen.

Uitvoerformaat

De MCP-server retourneert goed geformatteerde resultaten:

## E-mailverificatieresultaat

**E-mail:** test@example.com
**Status:** GELDIG
**Betrouwbaarheidsscore:** 95.0%

### Details
| Controle | Resultaat |
|----------|-----------|
| Afleverbaar | Ja |
| Geldig Formaat | Ja |
| Geldig Domein | Ja |
| Geldige MX | Ja |
| Wegwerp | Nee |
| Rol Adres | Nee |
| Catch-all | Nee |
| Gratis Provider | Nee |

**Gebruikte Credits:** 1

Best Practices

1. Sla API-sleutel Veilig Op

Hardcode nooit uw API-sleutel. Gebruik omgevingsvariabelen:

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

2. Gebruik Natuurlijke Taal

De MCP-server begrijpt verschillende formuleringen:

• "Verifieer user@example.com"
• "Is test@company.com een geldig e-mailadres?"
• "Controleer of dit e-mailadres afleverbaar is: john@test.com"
• "Kun je deze e-mailadressen voor me valideren?"

3. Batch Waar Mogelijk

Voor meerdere e-mails, vraag Claude om ze samen te verifiëren voor efficiëntie:

"Verifieer al deze e-mails tegelijk: email1@test.com, email2@test.com, email3@test.com"

Probleemoplossing

MCP-server Niet Gevonden

Als Claude zegt dat de BillionVerify-tool niet kan worden gevonden:

1. Controleer uw configuratiebestandspad
2. Zorg ervoor dat de JSON geldig is
3. Herstart Claude Desktop volledig
4. Verifieer dat uw API-sleutel correct is

Rate Limit Fouten

Als u rate limit-fouten ziet:

1. Controleer uw resterende credits met "Hoeveel credits heb ik?"
2. Wacht even en probeer opnieuw
3. Overweeg uw plan te upgraden voor hogere limieten

Verbindingsproblemen

Als verificatie mislukt:

1. Controleer uw internetverbinding
2. Verifieer dat uw API-sleutel geldig is
3. Probeer eerst een eenvoudige verificatie

FAQ

Is mijn API-sleutel veilig?

Ja. De API-sleutel wordt opgeslagen in uw lokale configuratiebestand en wordt alleen gebruikt door de MCP-server die op uw machine draait. Het wordt nooit naar derden gestuurd.

Welke AI-clients ondersteunen MCP?

Elke MCP-compatibele client werkt, inclusief Claude Desktop, Claude Code, Cursor, Zed, Cline en Continue.

Wat gebeurt er offline?

Als de BillionVerify API onbereikbaar is, retourneert de tool een foutmelding. Dit heeft geen invloed op Claude's andere mogelijkheden.

Hoe werken credits?

Elke e-mailverificatie gebruikt 1 credit. Bulkverificaties gebruiken 1 credit per e-mail. Controleer uw saldo met de check_credits tool.

Volgende Stappen