RevenueBase MCP サーバー
RevenueBaseの業界をリードするメール検証APIへのアクセスを提供するモデルコンテキストプロトコル（MCP）サーバー。このサーバーにより、AIアシスタントやアプリケーションは、キャッチオールドメインやファイアウォールで保護されたドメインを含むビジネスメールを99%以上の精度で検証できます。
特徴
リアルタイムメール検証：個々のメールアドレスを即座に検証
バッチメール処理：大規模なメールリストの送信と処理
プロセス管理: バッチ処理ジョブの監視、キャンセル、追跡
クレジット管理: 残りのAPIクレジットを確認する
APIキー管理: 新しいAPIキーを生成する
高精度：B2Bメール検証の精度は99%以上
キャッチオールドメインのサポート: 他のツールでは処理できないキャッチオールメールドメインを検証します
ファイアウォールナビゲーション: MimecastやBarracudaなどの電子メールファイアウォールをバイパスする
Related MCP server: Mercado Livre 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 サーバーに関する問題については、このリポジトリで問題を開いてください。