revenuebase-mcp-server
Servidor MCP de RevenueBase
Un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a la API de verificación de correo electrónico de RevenueBase, líder en el sector. Este servidor permite que los asistentes y aplicaciones de IA verifiquen correos electrónicos empresariales, incluyendo dominios catch-all y protegidos por firewall, con una precisión superior al 99 %.
Características
Verificación de correo electrónico en tiempo real : Verifique direcciones de correo electrónico individuales al instante
Procesamiento de correo electrónico por lotes : envíe y procese grandes listas de correo electrónico
Gestión de procesos : supervisar, cancelar y realizar un seguimiento de trabajos de procesamiento por lotes
Gestión de créditos : Consulta los créditos API restantes
Gestión de claves API : generar nuevas claves API
Alta precisión : más del 99 % de precisión para la verificación de correo electrónico B2B
Compatibilidad con dominios de captura general : verifique los dominios de correo electrónico de captura general que otras herramientas no pueden manejar
Navegación por firewall : evite firewalls de correo electrónico como Mimecast y Barracuda
Related MCP server: json-mcp-server
Acerca de RevenueBase
RevenueBase ofrece servicios de verificación de correo electrónico líderes en la industria, diseñados específicamente para proveedores de datos B2B. Con la capacidad de verificar dominios catch-all y protegidos por firewall, RevenueBase garantiza la máxima precisión donde otros servicios no alcanzan.
Obtenga más información sobre los servicios de verificación de correo electrónico de RevenueBase en: https://revenuebase.ai/email-list-cleaning/
Instalación
Clonar este repositorio:
git clone https://github.com/avivshafir/revenuebase-mcp-server
cd revenuebase-mcp-serverInstalar dependencias usando uv:
uv syncConfigure su clave API de RevenueBase:
export REVENUEBASE_API_KEY="your_api_key_here"Uso
Ejecución del servidor
python server.pyEl servidor se iniciará y estará disponible para conexiones MCP.
Uso con clientes MCP
Escritorio de Claude
Para utilizar este servidor con Claude Desktop, agregue la siguiente configuración a su archivo de configuración de Claude Desktop:
macOS : ~/Library/Application Support/Claude/claude_desktop_config.json Windows : %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"revenuebase": {
"command": "uv",
"args": ["--directory", "/path/to/revenuebase-mcp-server", "run", "python", "server.py"],
"env": {
"REVENUEBASE_API_KEY": "your_api_key_here"
}
}
}
}Reemplace /path/to/revenuebase-mcp-server con la ruta real a su repositorio clonado y your_api_key_here con su clave API de RevenueBase real.
Otros clientes de MCP
Para otros clientes MCP, puede conectarse al servidor mediante el transporte stdio. El servidor se ejecuta como un servidor MCP estándar y acepta conexiones en stdin/stdout.
Ejemplo que utiliza el SDK de Python de MCP:
from mcp import ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client
server_params = StdioServerParameters(
command="python",
args=["server.py"],
env={"REVENUEBASE_API_KEY": "your_api_key_here"}
)
async with stdio_client(server_params) as (read, write):
async with ClientSession(read, write) as session:
# Initialize the connection
await session.initialize()
# List available tools
tools = await session.list_tools()
print("Available tools:", [tool.name for tool in tools.tools])
# Call a tool
result = await session.call_tool("real_time_email_verification", {
"email": "test@example.com"
})
print("Verification result:", result)Herramientas disponibles
1. Verificación de correo electrónico en tiempo real
Verifique una sola dirección de correo electrónico al instante.
Parámetros:
email(cadena): la dirección de correo electrónico para verificar
Ejemplo:
real_time_email_verification("user@example.com")2. Envío de correos electrónicos por lotes
Envíe una referencia de archivo para el procesamiento de correo electrónico por lotes.
Parámetros:
filename(cadena): La referencia del nombre de archivo para el procesamiento por lotes
Ejemplo:
batch_email_submission("email_list.csv")3. Estado del proceso por lotes
Verifique el estado de un trabajo de procesamiento de correo electrónico por lotes.
Parámetros:
process_id(int): El ID del trabajo de procesamiento por lotes
Ejemplo:
batch_process_email_status(12345)4. Procesos en cola
Enumere todos los trabajos de procesamiento por lotes de correo electrónico en cola.
Ejemplo:
queued_process()5. Cancelar proceso
Cancelar un trabajo de procesamiento de correo electrónico por lotes en curso o en cola.
Parámetros:
process_id(int): El ID del proceso a cancelar
Ejemplo:
cancel_process(12345)6. Obtener créditos
Recupere el número de créditos restantes para su cuenta.
Ejemplo:
get_credits()7. Generar nueva clave API
Generar y devolver una nueva clave API.
Ejemplo:
new_api_key()Configuración
Variables de entorno
REVENUEBASE_API_KEY: Su clave API de RevenueBase (obligatoria)
Puntos finales de API
El servidor se conecta a los siguientes puntos finales de la API de RevenueBase:
https://api.revenuebase.ai/v1/process-email- Verificación de correo electrónico en tiempo realhttps://api.revenuebase.ai/v1/batch-process-email- Envío de correos electrónicos por loteshttps://api.revenuebase.ai/v1/batch-process-email-status- Comprobación del estado del lotehttps://api.revenuebase.ai/v1/queued-process- Lista de procesos en colahttps://api.revenuebase.ai/v1/cancel-process- Cancelar procesohttps://api.revenuebase.ai/v1/credits- Obtener créditoshttps://api.revenuebase.ai/v1/new-api-key- Generar nueva clave API
Manejo de errores
Todas las herramientas incluyen un manejo de errores adecuado y generarán RuntimeError si la clave API no está configurada. Los errores HTTP de la API RevenueBase se generan automáticamente usando requests.raise_for_status() .
Requisitos
Python 3.7+
fastmcp
solicitudes
Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.
Apoyo
Para obtener soporte y documentación de la API de RevenueBase, visita:
Si tiene problemas con este servidor MCP, abra un problema en este repositorio.
Available Tools
7 toolsbatch_email_submissionC
Submits a file reference for batch email processing using the Revenuebase API.
Inputs: filename (required).
batch_process_email_statusC
Retrieves status of batch email processing job.
Inputs: process_id (required).
cancel_processC
Cancels an ongoing or queued batch email processing job using the Revenuebase API.
Inputs: process_id (required).
get_creditsA
Retrieves the number of remaining credits for the authenticated user.
Inputs: no named parameters.
new_api_keyB
Generates and returns a new API key for the user.
Inputs: no named parameters.
queued_processB
Lists all queued email batch processing jobs.
Inputs: no named parameters.
real_time_email_verificationC
Verifies a single email address using the Revenuebase API.
Inputs: email (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool has a clearly distinct purpose with no overlap: batch_email_submission initiates processing, batch_process_email_status checks status, cancel_process stops jobs, get_credits shows credits, new_api_key generates keys, queued_process lists jobs, and real_time_email_verification verifies single emails. The descriptions reinforce these distinct functions, making tool selection unambiguous.
All tools follow a consistent snake_case naming pattern with clear verb-noun combinations (e.g., batch_email_submission, real_time_email_verification). The naming convention is uniform across all seven tools, making them predictable and easy to understand at a glance.
With 7 tools, this server is well-scoped for email verification and batch processing tasks. Each tool serves a specific, necessary function in the workflow, from initiation to status checks and management, without being overly sparse or bloated.
The tool set covers core email verification and batch processing operations comprehensively, including submission, status retrieval, cancellation, credit management, and API key generation. A minor gap exists in lacking a tool for detailed results of completed batch jobs, but agents can work around this using the status tool.
Maintenance
Related MCP Connectors
MCP server for customer-io
Related MCP Servers
- -
- MIT
- MIT
- Apache 2.0