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
Related MCP server: json-mcp-server
Ü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-serverInstallieren Sie Abhängigkeiten mit uv:
uv syncRichten Sie Ihren RevenueBase-API-Schlüssel ein:
export REVENUEBASE_API_KEY="your_api_key_here"Verwendung
Ausführen des Servers
python server.pyDer 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 Echtzeithttps://api.revenuebase.ai/v1/batch-process-email– Batch-E-Mail-Übermittlunghttps://api.revenuebase.ai/v1/batch-process-email-status– Stapelstatusprüfunghttps://api.revenuebase.ai/v1/queued-process– Liste der in die Warteschlange gestellten Prozessehttps://api.revenuebase.ai/v1/cancel-process- Vorgang abbrechenhttps://api.revenuebase.ai/v1/credits– Guthaben erhaltenhttps://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.
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