Skip to main content
Glama
revenuebase-mcp-server

revenuebase-mcp-server

by avivshafir

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

  1. Clonar este repositorio:

git clone https://github.com/avivshafir/revenuebase-mcp-server
cd revenuebase-mcp-server
  1. Instalar dependencias usando uv:

uv sync
  1. Configure su clave API de RevenueBase:

export REVENUEBASE_API_KEY="your_api_key_here"

Uso

Ejecución del servidor

python server.py

El 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 real

  • https://api.revenuebase.ai/v1/batch-process-email - Envío de correos electrónicos por lotes

  • https://api.revenuebase.ai/v1/batch-process-email-status - Comprobación del estado del lote

  • https://api.revenuebase.ai/v1/queued-process - Lista de procesos en cola

  • https://api.revenuebase.ai/v1/cancel-process - Cancelar proceso

  • https://api.revenuebase.ai/v1/credits - Obtener créditos

  • https://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 tools
batch_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

    B3.4/5.0

    Scored across 7 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers