Revenuebase-MCP-Server

RevenueBase MCP-Server

Ein Model Context Protocol (MCP)-Server, der Zugriff auf die branchenführende E-Mail-Verifizierungs-API von RevenueBase bietet. Dieser Server ermöglicht KI-Assistenten und -Anwendungen die Verifizierung von Geschäfts-E-Mails, einschließlich Catch-All- und Firewall-geschützter Domänen, mit einer Genauigkeit von über 99 %.

Merkmale

E-Mail-Verifizierung in Echtzeit : Verifizieren Sie einzelne E-Mail-Adressen sofort
Stapelverarbeitung von E-Mails : Senden und verarbeiten Sie große E-Mail-Listen
Prozessmanagement : Stapelverarbeitungsaufträge überwachen, abbrechen und verfolgen
Kreditverwaltung : Überprüfen Sie die verbleibenden API-Guthaben
API-Schlüsselverwaltung : Neue API-Schlüssel generieren
Hohe Genauigkeit : Über 99 % Genauigkeit bei der B2B-E-Mail-Verifizierung
Catch-All-Domain-Unterstützung : Überprüfen Sie Catch-All-E-Mail-Domains, die andere Tools nicht verarbeiten können
Firewall-Navigation : Umgehen Sie E-Mail-Firewalls wie Mimecast und Barracuda

Über RevenueBase

RevenueBase bietet branchenführende E-Mail-Verifizierungsdienste, die speziell für B2B-Datenanbieter entwickelt wurden. Mit der Möglichkeit, Catch-All- und Firewall-geschützte Domänen zu verifizieren, gewährleistet RevenueBase maximale Genauigkeit, wo andere Dienste versagen.

Erfahren Sie mehr über die E-Mail-Verifizierungsdienste von RevenueBase unter: https://revenuebase.ai/email-list-cleaning/

Installation

Klonen Sie dieses Repository:

git clone https://github.com/avivshafir/revenuebase-mcp-server
cd revenuebase-mcp-server

Installieren Sie Abhängigkeiten mit uv:

uv sync

Richten Sie Ihren RevenueBase-API-Schlüssel ein:

export REVENUEBASE_API_KEY="your_api_key_here"

Verwendung

Ausführen des Servers

python server.py

Der Server wird gestartet und ist für MCP-Verbindungen verfügbar.

Verwendung mit MCP-Clients

Claude Desktop

Um diesen Server mit Claude Desktop zu verwenden, fügen Sie Ihrer Claude Desktop-Konfigurationsdatei die folgende Konfiguration hinzu:

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

Ersetzen Sie /path/to/revenuebase-mcp-server durch den tatsächlichen Pfad zu Ihrem geklonten Repository und your_api_key_here durch Ihren tatsächlichen RevenueBase-API-Schlüssel.

Andere MCP-Clients

Für andere MCP-Clients können Sie über den stdio-Transport eine Verbindung zum Server herstellen. Der Server läuft als Standard-MCP-Server und akzeptiert Verbindungen über stdin/stdout.

Beispiel mit dem MCP Python SDK:

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)

Verfügbare Tools

1. E-Mail-Verifizierung in Echtzeit

Bestätigen Sie sofort eine einzelne E-Mail-Adresse.

Parameter:

email (Zeichenfolge): Die zu verifizierende E-Mail-Adresse

Beispiel:

real_time_email_verification("user@example.com")

2. Batch-E-Mail-Übermittlung

Senden Sie eine Dateireferenz für die Stapelverarbeitung von E-Mails.

Parameter:

filename (Zeichenfolge): Die Dateinamenreferenz für die Stapelverarbeitung

Beispiel:

batch_email_submission("email_list.csv")

3. Status des Stapelprozesses

Überprüfen Sie den Status eines Batch-E-Mail-Verarbeitungsauftrags.

Parameter:

process_id (int): Die ID des Batchverarbeitungsauftrags

Beispiel:

batch_process_email_status(12345)

4. Prozesse in der Warteschlange

Listen Sie alle in der Warteschlange befindlichen Stapelverarbeitungsaufträge für E-Mails auf.

Beispiel:

queued_process()

5. Vorgang abbrechen

Brechen Sie einen laufenden oder in die Warteschlange gestellten Batch-E-Mail-Verarbeitungsauftrag ab.

Parameter:

process_id (int): Die ID des abzubrechenden Prozesses

Beispiel:

cancel_process(12345)

6. Credits erhalten

Rufen Sie die Anzahl der verbleibenden Credits für Ihr Konto ab.

Beispiel:

get_credits()

7. Neuen API-Schlüssel generieren

Generieren und geben Sie einen neuen API-Schlüssel zurück.

Beispiel:

new_api_key()

Konfiguration

Umgebungsvariablen

REVENUEBASE_API_KEY : Ihr RevenueBase-API-Schlüssel (erforderlich)

API-Endpunkte

Der Server stellt eine Verbindung zu den folgenden RevenueBase-API-Endpunkten her:

https://api.revenuebase.ai/v1/process-email – E-Mail-Verifizierung in Echtzeit
https://api.revenuebase.ai/v1/batch-process-email – Batch-E-Mail-Übermittlung
https://api.revenuebase.ai/v1/batch-process-email-status – Stapelstatusprüfung
https://api.revenuebase.ai/v1/queued-process – Liste der in die Warteschlange gestellten Prozesse
https://api.revenuebase.ai/v1/cancel-process - Vorgang abbrechen
https://api.revenuebase.ai/v1/credits – Guthaben erhalten
https://api.revenuebase.ai/v1/new-api-key – Neuen API-Schlüssel generieren

Fehlerbehandlung

Alle Tools verfügen über eine ordnungsgemäße Fehlerbehandlung und lösen RuntimeError aus, wenn der API-Schlüssel nicht konfiguriert ist. HTTP-Fehler der RevenueBase-API werden automatisch mit requests.raise_for_status() ausgelöst.

Anforderungen

Python 3.7+
fastmcp
Anfragen

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .

Unterstützung

Support und Dokumentation zur RevenueBase-API finden Sie unter:

Bei Problemen mit diesem MCP-Server öffnen Sie bitte ein Problem in diesem Repository.

revenuebase-mcp-server