EmailCheckPro Referencia de MCP

El Model Context Protocol permite a las aplicaciones de IA llamar a herramientas externas durante una conversación. Pida a su asistente que verifique un correo o revise un lote sin escribir una integración de API aparte.

MCP es un adaptador de protocolo. Usa los mismos productos, saldo, facturación, límites de concurrencia, tiempos de espera y semántica de resultados que la API REST.

Los productos, los precios y los límites figuran en la referencia de la API

Autenticación

Use exactamente la misma clave API que en la API REST y añádala como token Bearer en la configuración de su cliente MCP.

Cabecera Authorization
Authorization: Bearer YOUR_API_KEY

Mantenga su clave API privadaAñada la clave solo a la configuración de su propio cliente de confianza. Nunca la exponga en código de navegador ni en prompts públicos.

URL del servidor

Dirija su cliente al endpoint oficial de Streamable HTTP. No se requiere ningún proceso MCP local.

ElementoValor
Endpoint MCPhttps://emailcheckpro.com/mcp
Streamable HTTPLas solicitudes usan JSON-RPC sobre Streamable HTTP y el mismo middleware de clave API que REST.

Conecte su cliente

Elija el formato de configuración que admita su cliente. Sustituya el marcador de posición por su clave API.

claude mcp add --transport http emailcheckpro https://emailcheckpro.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Añada el servidor remoto desde su terminal.

Herramientas disponibles

Las herramientas se limitan a la aplicación a la que pertenece su clave API. Llame primero a list_products cuando necesite descubrir los códigos de producto válidos.

list_products

Enumera productos, precios, multiplicadores de facturación y campos de respuesta.

Parámetros
Sin parámetros

check_number

Verifica un correo de forma síncrona. registered es el resultado principal.

Parámetros
service_type · string · obligatorio
identifier · string · obligatorio

check_numbers

Verifica de 1 a 100 correos con un mismo service_type y conserva el orden de entrada.

Parámetros
service_type · string · obligatorio
identifiers · string[] · obligatorio · máx. 100

get_balance

Consulta el saldo actual de la cuenta sin realizar ningún cargo.

Parámetros
Sin parámetros

Ejemplos de prompts

Tras conectarse, pregunte a su asistente en lenguaje natural:

  • Comprueba si name@example.com es entregable, es decir, si puede recibir correo.
  • Verifica estos 20 correos y resume los resultados.
  • ¿Cuánto saldo queda antes de ejecutar este lote?

Gestión de errores

Los fallos de las herramientas usan isError=true y el mismo contrato code, msg, data que la API.

Ejemplo de error de herramienta

{
  "code": 42901,
  "msg": "too many concurrent requests",
  "data": null
}
CódigoDescripción
40000Producto o campo no válidoservice_type no compatible o campos en conflicto.
40002Correo no válidoEl correo enviado no tiene un formato válido.
40100Clave API ausente o no válidaRevise la cabecera Bearer y confirme que la clave está activa.
40200Saldo insuficienteLa solicitud se rechaza antes de procesarse cuando no se puede cubrir el importe completo del lote.
42200IndeterminadoNo se ha podido determinar el correo en este momento. No se devuelve ningún resultado y esta llamada no se cobra.
42901Cupo de concurrencia completoLas cinco plazas de solicitudes simultáneas están ocupadas o ya hay una verificación múltiple en ejecución en esta cuenta. No se cobra; reintente cuando termine una.
50303Servicio a plena capacidadHay demasiadas verificaciones en curso en toda la plataforma. No se cobra; espere los segundos indicados en Retry-After y vuelva a enviarla.
50400La verificación ha superado el tiempo de esperaNo finalizó a tiempo. No se cobra; una verificación múltiple que supera el tiempo de espera falla en su totalidad y se reembolsa íntegramente.
50300Mantenimiento del servicioInténtelo de nuevo más tarde.