MCP Server

Model Context Protocol (MCP) is een open standaard waarmee AI-clients externe tools kunnen aanroepen via een gedeelde interface. BillionVerify biedt een gehoste MCP-server voor e-mailverificatie, accountrapportage, resultaatdownloads en webhookbeheer via Streamable HTTP.

Belangrijk

De BillionVerify MCP-server ondersteunt geen ?api_key=... queryparameters, resource-URI's met ingesloten API-sleutels of toolargumenten met api_key.

Als je eerder curl --stdio "https://mcp.billionverify.com/mcp?api_key=..." gebruikte, werkt die flow niet meer. Gebruik in plaats daarvan een OAuth-compatibele remote MCP-client. Ondersteunt jouw client alleen lokale stdio + API-sleutels, gebruik dan de BillionVerify REST API in plaats van MCP.

Wat je kunt doen

• Eén e-mailadres verifiëren
• Tot 50 e-mailadressen in één batchverzoek verifiëren
• Het creditsaldo van je account opvragen
• De status van asynchrone verificatietaken volgen
• Gefilterde downloadlinks genereren voor afgeronde jobs
• Verificatiegeschiedenis en geaggregeerde statistieken bekijken
• Webhooks voor lifecycle-meldingen aanmaken, tonen en verwijderen

Hoe authenticatie werkt

BillionVerify MCP gebruikt een standaard remote OAuth-flow:

1. Je MCP-client ontdekt de protected resource metadata via https://mcp.billionverify.com/.well-known/oauth-protected-resource.
2. De client volgt automatisch de gepubliceerde metadata van de authorization server.
3. Je logt in met je BillionVerify-account en keurt de gevraagde scopes goed.
4. Daarna roept de client https://mcp.billionverify.com/mcp aan met Authorization: Bearer <access_token>.

Beschikbare scopes

Verbinden vanuit ChatGPT

Gebruik deze remote MCP-server-URL wanneer je BillionVerify vanuit ChatGPT wilt verbinden:

https://mcp.billionverify.com/mcp

ChatGPT ontdekt automatisch de OAuth-protected resource metadata, leidt je door BillionVerify login en consent en roept daarna de MCP-server aan met een access token.

Na het koppelen kun je bijvoorbeeld vragen:

• Verify jane@company.com
• Check my current BillionVerify credit balance
• Show my recent verification history
• Get a download link for only valid emails from job 36f68e67-ddcb-441a-a407-22f826e72443

Verbinden vanuit andere MCP-clients

Elke MCP-client die het volgende ondersteunt:

• remote MCP via Streamable HTTP
• OAuth-protected resources
• standaard Bearer-tokenauthenticatie

kan verbinden met hetzelfde endpoint:

https://mcp.billionverify.com/mcp

Gebruik de remote MCP-configuratie van je client en vul bovenstaande URL in. Gebruik geen curl --stdio wrapper en voeg geen API-sleutel toe aan de URL.

Wanneer je beter de REST API gebruikt

Gebruik de BillionVerify REST API in plaats van MCP als:

• je client alleen lokale stdio MCP-servers ondersteunt
• je integratie afhankelijk is van API-sleutels in plaats van OAuth
• je backend-naar-backend automatisering bouwt zonder MCP-client

API-sleutels bestaan nog steeds voor de BillionVerify REST API. Ze maken alleen geen deel meer uit van het MCP-authenticatiemodel.

Beschikbare tools

Beschikbare resources

Voorbeeldprompts

Eén e-mailadres verifiëren

Verify john@google.com

Batchverificatie

Verify these emails in one request: john@google.com, test@mailinator.com, support@microsoft.com

Accountsaldo

How many BillionVerify credits do I have left?

Verificatiegeschiedenis

Show my 20 most recent verification jobs

Gefilterde resultaten downloaden

Get a download link for only valid emails from job job-123

Webhookbeheer

Create a webhook for file.completed and file.failed events at https://example.com/webhooks/billionverify

Voorbeeld MCP-antwoorden

verify_single_email

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

get_task_status

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

get_account_balance

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

Problemen oplossen

Ik krijg 401, een OAuth-prompt of mcp/www_authenticate

Dat betekent meestal dat de client de OAuth-autorisatie nog niet heeft afgerond, dat het access token is verlopen of dat de vereiste scope ontbreekt. Koppel de MCP-server opnieuw en keur de gevraagde scopes goed.

Mijn client ondersteunt alleen curl --stdio of lokale JSON-configuratie met API-sleutels

Die client is niet compatibel met het huidige remote MCP-authenticatiemodel van BillionVerify. Gebruik in dat geval de BillionVerify REST API.

Ik gebruikte vroeger ?api_key=... en nu werkt het niet meer

Die legacy-flow is verwijderd uit het MCP-oppervlak. Stap over op een OAuth-compatibele MCP-client en verbind direct met het remote endpoint.

Hoe werken credits?

• Geldig e-mailadres: 1 credit
• Ongeldig e-mailadres: 0 credits
• Onbekend e-mailadres: 0 credits

Gebruik get_account_balance om je resterende saldo te bekijken.

FAQ

Ondersteunt de MCP-server API-sleutels?

Nee. De remote MCP-server vereist OAuth access tokens. Ontwikkelaars-API-sleutels zijn voor de REST API, niet voor het opzetten van een MCP-verbinding.

Welke clients worden ondersteund?

Elke client die remote MCP via Streamable HTTP en OAuth-protected resources ondersteunt, kan verbinden. ChatGPT is daar een voorbeeld van. Voor clients zonder remote OAuth MCP-ondersteuning gebruik je de REST API.

Moet ik een npm-pakket installeren?

Nee. Dit is een gehoste remote MCP-server. Je verbindt direct met https://mcp.billionverify.com/mcp.

Kan ik geschiedenis en statistieken via MCP ophalen?

Ja. Gebruik get_verification_history, get_verification_stats of de equivalente read-only resources.

Volgende stappen