revenuebase-mcp-server
RevenueBase MCP サーバー
RevenueBaseの業界をリードするメール検証APIへのアクセスを提供するモデルコンテキストプロトコル(MCP)サーバー。このサーバーにより、AIアシスタントやアプリケーションは、キャッチオールドメインやファイアウォールで保護されたドメインを含むビジネスメールを99%以上の精度で検証できます。
特徴
リアルタイムメール検証:個々のメールアドレスを即座に検証
バッチメール処理:大規模なメールリストの送信と処理
プロセス管理: バッチ処理ジョブの監視、キャンセル、追跡
クレジット管理: 残りのAPIクレジットを確認する
APIキー管理: 新しいAPIキーを生成する
高精度:B2Bメール検証の精度は99%以上
キャッチオールドメインのサポート: 他のツールでは処理できないキャッチオールメールドメインを検証します
ファイアウォールナビゲーション: MimecastやBarracudaなどの電子メールファイアウォールをバイパスする
Related MCP server: json-mcp-server
RevenueBaseについて
RevenueBaseは、B2Bデータプロバイダー向けに特別に構築された、業界をリードするメール検証サービスを提供しています。キャッチオールドメインやファイアウォールで保護されたドメインの検証機能により、RevenueBaseは他のサービスでは実現できない最高の精度を保証します。
RevenueBase のメール検証サービスの詳細については、 https://revenuebase.ai/email-list-cleaning/をご覧ください。
インストール
このリポジトリをクローンします:
git clone https://github.com/avivshafir/revenuebase-mcp-server
cd revenuebase-mcp-serveruv を使用して依存関係をインストールします。
uv syncRevenueBase API キーを設定します。
export REVENUEBASE_API_KEY="your_api_key_here"使用法
サーバーの実行
python server.pyサーバーが起動し、MCP 接続が使用できるようになります。
MCPクライアントでの使用
クロードデスクトップ
このサーバーを Claude Desktop で使用するには、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"
}
}
}
}/path/to/revenuebase-mcp-serverクローンしたリポジトリへの実際のパスに置き換え、 your_api_key_here実際の RevenueBase API キーに置き換えます。
その他のMCPクライアント
その他のMCPクライアントは、stdioトランスポートを使用してサーバーに接続できます。サーバーは標準のMCPサーバーとして動作し、stdin/stdoutからの接続を受け入れます。
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)利用可能なツール
1. リアルタイムメール認証
単一の電子メール アドレスを即座に検証します。
パラメータ:
email(文字列): 確認するメールアドレス
例:
real_time_email_verification("user@example.com")2. 一括メール送信
バッチ電子メール処理用のファイル参照を送信します。
パラメータ:
filename(文字列): バッチ処理のファイル名参照
例:
batch_email_submission("email_list.csv")3. バッチ処理ステータス
バッチ電子メール処理ジョブのステータスを確認します。
パラメータ:
process_id(int): バッチ処理ジョブのID
例:
batch_process_email_status(12345)4. キュープロセス
キューに入れられたすべての電子メールバッチ処理ジョブを一覧表示します。
例:
queued_process()5. キャンセル手続き
進行中またはキューに入れられたバッチ電子メール処理ジョブをキャンセルします。
パラメータ:
process_id(int): キャンセルするプロセスのID
例:
cancel_process(12345)6. クレジットを取得する
アカウントに残っているクレジットの数を取得します。
例:
get_credits()7. 新しいAPIキーを生成する
新しい API キーを生成して返します。
例:
new_api_key()構成
環境変数
REVENUEBASE_API_KEY: RevenueBase APIキー(必須)
APIエンドポイント
サーバーは、次の RevenueBase API エンドポイントに接続します。
https://api.revenuebase.ai/v1/process-email- リアルタイムのメール認証https://api.revenuebase.ai/v1/batch-process-email- 一括メール送信https://api.revenuebase.ai/v1/batch-process-email-status- バッチステータスチェックhttps://api.revenuebase.ai/v1/queued-process- キューに入れられたプロセスを一覧表示するhttps://api.revenuebase.ai/v1/cancel-process- キャンセルプロセスhttps://api.revenuebase.ai/v1/credits- クレジットを取得https://api.revenuebase.ai/v1/new-api-key- 新しいAPIキーを生成する
エラー処理
すべてのツールには適切なエラー処理が組み込まれており、APIキーが設定されていない場合はRuntimeErrorが発生します。RevenueBase APIからのHTTPエラーは、 requests.raise_for_status()を使用して自動的に発生します。
要件
Python 3.7以上
ファストmcp
リクエスト
ライセンス
このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。
サポート
RevenueBase API のサポートとドキュメントについては、以下をご覧ください。
この MCP サーバーに関する問題については、このリポジトリで問題を開いてください。
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