MCP Server

Model Context Protocol (MCP) es un protocolo abierto de Anthropic que permite a los modelos de IA interactuar de forma segura con herramientas externas y fuentes de datos. BillionVerify proporciona capacidades de verificación de correo electrónico de nivel empresarial para agentes de IA a través de HTTP Streamable Transport, haciendo la integración increíblemente simple.

Por qué los agentes de IA necesitan verificación de correo electrónico

Los casos de uso modernos de agentes de IA incluyen:

• Claude Code necesita verificar direcciones de correo electrónico al procesar datos de usuarios
• OpenCode requiere validación de correo electrónico en flujos de trabajo automatizados
• Gemini CLI los agentes necesitan garantía de calidad al manejar datos de registro
• Codex el código generado necesita lógica de verificación de correo electrónico incorporada
• Agentes de IA personalizados necesitan confirmar la autenticidad del contacto al interactuar con humanos

BillionVerify MCP permite que cualquier agente de IA llame directamente a servicios de verificación de correo electrónico de nivel empresarial a través del estándar HTTP Streamable Transport - sin necesidad de configuración compleja.

Características principales

1. Verificación de correo electrónico individual en tiempo real

• Verificar formato de correo electrónico, dominio y registros MX
• Verificación de conexión SMTP opcional
• Detección de correo electrónico desechable
• Identificación de correo electrónico empresarial vs gratuito
• Detección de correo electrónico basado en rol (support@, noreply@, etc.)
• Tiempo de respuesta promedio < 2 segundos

2. Verificación de correo electrónico por lotes

• Verificar hasta 50 correos electrónicos a la vez
• Procesamiento concurrente para eficiencia
• Resultados detallados y estadísticas

3. Sistema de caché inteligente

• Correos electrónicos válidos en caché por 7 días
• Correos electrónicos inválidos en caché por 7 días
• Estado desconocido en caché por 10 minutos
• Reduce verificaciones repetidas innecesarias

4. Facturación precisa de créditos

• Correo electrónico válido: 1 crédito
• Correo electrónico inválido: 0 créditos (previene desperdicio)
• Estado desconocido: 0 créditos (reintento automático)
• Consultas de saldo en tiempo real

Clientes de IA compatibles

Configuración rápida (HTTP Transport - Recomendado)

¡La forma más simple de integrar - sin paquetes npm que instalar!

Paso 1: Obtener clave de API

Visite el Panel de BillionVerify para crear su clave de API.

Paso 2: Configurar Claude Desktop

Edite el archivo de configuración:

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

Reemplace YOUR_API_KEY con su clave de API real, luego reinicie Claude Desktop.

¡Eso es todo! Sin npm install, sin dependencias. curl está preinstalado en todos los sistemas. Claude ahora tiene capacidades de verificación de correo electrónico.

Paso 3: Comenzar a verificar

En su conversación, simplemente pregunte:

Por favor verifica este correo electrónico: user@example.com

Claude llamará automáticamente a BillionVerify y devolverá resultados detallados.

Configuración de Claude Code

Para Claude Code CLI, agregue el servidor MCP:

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

O agregue a su ~/.claude.json:

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

Configuración de OpenCode

Para OpenCode, configure en su ~/.opencode/config.json:

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

Configuración de Gemini CLI

Para Gemini CLI, agregue a su configuración:

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

Configuración de Cursor

En Cursor, vaya a Settings > MCP y agregue:

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

Método NPX (Alternativo)

Si prefiere el enfoque del paquete npm:

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

Herramientas disponibles

verify_single_email

Verificar una sola dirección de correo electrónico con validación integral.

Parámetros:

Devuelve:

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

Ejemplo de uso en Claude:

"Verifica si test@example.com es un correo electrónico válido"

verify_batch_emails

Verificar múltiples direcciones de correo electrónico a la vez (máx. 50).

Parámetros:

Devuelve:

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

Ejemplo de uso en Claude:

"Verifica estos correos: user1@example.com, user2@test.com, info@company.com"

get_account_balance

Verificar créditos de cuenta y estadísticas de uso.

Parámetros: Ninguno

Devuelve:

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

Ejemplo de uso en Claude:

"¿Cuántos créditos de verificación me quedan?"

health_check

Verificar el estado de salud del servidor MCP.

Parámetros: Ninguno

Devuelve:

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

get_task_status

Consultar el progreso de la tarea de verificación de archivos.

Parámetros:

Devuelve:

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

Ejemplo de uso en Claude:

"¿Cuál es el estado de mi tarea de verificación de archivo job-123?"

get_download_url

Obtener enlace de descarga de resultados de verificación con filtros de estado opcionales.

Parámetros:

Ejemplo de uso en Claude:

"Obtén el enlace de descarga solo para correos válidos de job-123"

create_webhook

Crear un webhook para recibir notificaciones de finalización de verificación.

Parámetros:

Devuelve:

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

Nota: El secret solo se devuelve una vez en la creación. Guárdelo para la verificación de firma.

Ejemplo de uso en Claude:

"Crea un webhook para notificarme cuando se complete la verificación del archivo"

list_webhooks

Listar todos los webhooks de la cuenta actual.

Parámetros: Ninguno

Devuelve:

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

Ejemplo de uso en Claude:

"Muéstrame todos mis webhooks configurados"

delete_webhook

Eliminar un webhook específico.

Parámetros:

Ejemplo de uso en Claude:

"Elimina el webhook con ID webhook-123"

Ejemplos de uso

Verificación básica

Usuario:

Verifica john@google.com

Claude:

Verificaré esa dirección de correo electrónico por ti.

Resultado de verificación de correo electrónico

Campo	Valor
Correo electrónico	john@google.com
Estado	Válido
Entregable	Sí
Desechable	No
Puntuación	0.95

Este correo electrónico parece ser válido y entregable.

Verificación de múltiples correos electrónicos

Usuario:

Verifica estos correos: john@google.com, test@mailinator.com, support@microsoft.com

Claude:

Verificaré las tres direcciones de correo electrónico.

Correo electrónico	Estado	Notas
john@google.com	Válido	Entregable, correo corporativo
test@mailinator.com	Inválido	Correo desechable, se recomienda rechazar
support@microsoft.com	Válido	Dirección basada en rol, puede ser compartida

Recomendaciones:

• john@google.com - Seguro de usar
• test@mailinator.com - Correo temporal, no recomendado
• support@microsoft.com - Válido pero probablemente un buzón de equipo

Flujo de trabajo de desarrollador

Usuario (en Claude Code):

Verifica los correos electrónicos de prueba en mi archivo .env.example

Claude:

Leeré el archivo y verificaré las direcciones de correo electrónico encontradas.

Encontré 3 direcciones de correo electrónico en .env.example:

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

Resultados de verificación:

Correo electrónico	Estado
user@example.com	Desconocido (dominio de ejemplo)
admin@company.com	Válido
help@temp-mail.org	Inválido (desechable)

Considere usar direcciones de correo electrónico reales para pruebas.

Formato de salida

El servidor MCP devuelve resultados bien formateados:

## Resultado de verificación de correo electrónico

**Correo electrónico:** test@example.com
**Estado:** VÁLIDO
**Puntuación de confianza:** 95.0%

### Detalles
| Verificación | Resultado |
|-------|--------|
| Entregable | Sí |
| Formato válido | Sí |
| Dominio válido | Sí |
| MX válido | Sí |
| Desechable | No |
| Dirección de rol | No |
| Catch-all | No |
| Proveedor gratuito | No |

**Créditos usados:** 1

Mejores prácticas

1. Almacenar clave de API de forma segura

Nunca codifique su clave de API. Use variables de entorno:

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

2. Usar lenguaje natural

El servidor MCP entiende varias formas de expresión:

• "Verifica user@example.com"
• "¿Es test@company.com un correo electrónico válido?"
• "Verifica si este correo es entregable: john@test.com"
• "¿Puedes validar estas direcciones de correo electrónico por mí?"

3. Agrupar cuando sea posible

Para múltiples correos electrónicos, pida a Claude que los verifique juntos para mayor eficiencia:

"Verifica todos estos correos a la vez: email1@test.com, email2@test.com, email3@test.com"

Solución de problemas

Servidor MCP no encontrado

Si Claude dice que no puede encontrar la herramienta BillionVerify:

1. Verifique la ruta del archivo de configuración
2. Asegúrese de que el JSON sea válido
3. Reinicie Claude Desktop completamente
4. Verifique que su clave de API sea correcta

Errores de límite de tasa

Si ve errores de límite de tasa:

1. Verifique sus créditos restantes con "¿Cuántos créditos tengo?"
2. Espere un momento e intente nuevamente
3. Considere actualizar su plan para límites más altos

Problemas de conexión

Si la verificación falla:

1. Verifique su conexión a Internet
2. Verifique que su clave de API sea válida
3. Intente primero una verificación simple

FAQ

¿Mi clave de API es segura?

Sí. La clave de API se almacena en su archivo de configuración local y solo la usa el servidor MCP que se ejecuta en su máquina. Nunca se envía a terceros.

¿Qué clientes de IA admiten MCP?

Cualquier cliente compatible con MCP funciona, incluidos Claude Desktop, Claude Code, Cursor, Zed, Cline y Continue.

¿Qué sucede cuando está sin conexión?

Si la API de BillionVerify no es accesible, la herramienta devuelve un mensaje de error. Esto no afecta las otras capacidades de Claude.

¿Cómo funcionan los créditos?

Cada verificación de correo electrónico usa 1 crédito. Las verificaciones masivas usan 1 crédito por correo electrónico. Verifique su saldo con la herramienta check_credits.

Próximos pasos