MCP Server

Model Context Protocol (MCP) es un estándar abierto que permite a los clientes de IA llamar herramientas externas mediante una interfaz compartida. BillionVerify ofrece un servidor MCP alojado para verificación de correos, reportes de cuenta, descargas de resultados y gestión de webhooks a través de Streamable HTTP.

Importante

El servidor MCP de BillionVerify no admite parámetros de consulta ?api_key=..., URIs de recursos con claves API incrustadas ni argumentos api_key en las herramientas.

Si antes usabas curl --stdio "https://mcp.billionverify.com/mcp?api_key=...", ese flujo ya no está soportado. Usa un cliente MCP remoto compatible con OAuth. Si tu cliente solo soporta stdio local + API keys, utiliza la API REST de BillionVerify en lugar de MCP.

Qué puedes hacer

• Verificar una sola dirección de correo
• Verificar hasta 50 correos en una sola llamada por lotes
• Consultar el saldo de créditos de la cuenta
• Seguir el estado de tareas asíncronas de verificación
• Generar enlaces de descarga filtrados para trabajos completados
• Consultar historial y estadísticas agregadas de verificación
• Crear, listar y eliminar webhooks de notificaciones

Cómo funciona la autenticación

BillionVerify MCP usa un flujo estándar de OAuth remoto:

1. Tu cliente MCP descubre los metadatos del recurso protegido en https://mcp.billionverify.com/.well-known/oauth-protected-resource.
2. El cliente sigue automáticamente los metadatos del servidor de autorización.
3. Inicias sesión con tu cuenta de BillionVerify y apruebas los scopes solicitados.
4. El cliente llama a https://mcp.billionverify.com/mcp con Authorization: Bearer <access_token>.

Scopes disponibles

Conectar desde ChatGPT

Si vas a conectar BillionVerify desde ChatGPT, usa esta URL del servidor MCP remoto:

https://mcp.billionverify.com/mcp

ChatGPT descubrirá automáticamente los metadatos OAuth del recurso protegido, te redirigirá al inicio de sesión y consentimiento de BillionVerify, y luego llamará al servidor MCP con un access token.

Después de autorizar la conexión, puedes pedir cosas como:

• 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

Conectar desde otros clientes MCP

Cualquier cliente MCP que soporte:

• MCP remoto sobre Streamable HTTP
• OAuth-protected resources
• autenticación estándar con Bearer token

puede conectarse al mismo endpoint:

https://mcp.billionverify.com/mcp

Usa el flujo de configuración MCP remota de tu cliente y proporciona la URL anterior. No envuelvas el servidor con curl --stdio ni añadas una API key en la URL.

Cuándo usar la API REST en su lugar

Usa la API REST de BillionVerify en vez de MCP si:

• tu cliente solo soporta servidores MCP locales por stdio
• tu integración depende de API keys en lugar de OAuth
• estás construyendo una automatización backend a backend sin un cliente MCP

Las API keys siguen existiendo para la API REST de BillionVerify. Simplemente ya no forman parte del modelo de autenticación de MCP.

Herramientas disponibles

Recursos disponibles

Ejemplos de prompts

Verificar un solo correo

Verify john@google.com

Verificación por lotes

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

Saldo de la cuenta

How many BillionVerify credits do I have left?

Historial de verificación

Show my 20 most recent verification jobs

Descargar resultados filtrados

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

Gestión de webhooks

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

Ejemplos de respuestas MCP

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

Solución de problemas

Recibo 401, un prompt de OAuth o mcp/www_authenticate

Normalmente significa que el cliente no ha completado la autorización OAuth, que el access token ha expirado o que falta algún scope requerido. Vuelve a conectar el servidor MCP y aprueba los scopes solicitados.

Mi cliente solo soporta curl --stdio o configuración JSON local con API keys

Ese cliente no es compatible con el modelo actual de autenticación remota MCP de BillionVerify. Usa la API REST de BillionVerify en su lugar.

Antes me conectaba con ?api_key=... y ahora ya no funciona

Ese flujo heredado fue eliminado de la superficie MCP. Cambia a un cliente MCP compatible con OAuth y conecta directamente al endpoint remoto.

¿Cómo funcionan los créditos?

• Correo válido: 1 crédito
• Correo inválido: 0 créditos
• Correo desconocido: 0 créditos

Usa get_account_balance para revisar tu saldo restante.

FAQ

¿El servidor MCP admite API keys?

No. El servidor MCP remoto requiere access tokens OAuth. Las API keys de desarrollador son para la API REST, no para iniciar la conexión MCP.

¿Qué clientes están soportados?

Cualquier cliente que soporte MCP remoto sobre Streamable HTTP y OAuth-protected resources puede conectarse. ChatGPT es un ejemplo. Para clientes sin soporte de OAuth remoto para MCP, usa la API REST.

¿Necesito instalar un paquete npm?

No. Este es un servidor MCP remoto alojado. Te conectas directamente a https://mcp.billionverify.com/mcp.

¿Puedo consultar historial y estadísticas desde MCP?

Sí. Usa get_verification_history, get_verification_stats o los recursos equivalentes de solo lectura.

Siguientes pasos