revenuebase-mcp-server
RevenueBase MCP 服务器
一个模型上下文协议 (MCP) 服务器,提供对 RevenueBase 业界领先的电子邮件验证 API 的访问。该服务器使 AI 助手和应用程序能够验证企业电子邮件,包括全域邮件和受防火墙保护的域名,准确率超过 99%。
特征
实时电子邮件验证:立即验证个人电子邮件地址
批量电子邮件处理:提交和处理大量电子邮件列表
流程管理:监控、取消和跟踪批处理作业
信用管理:检查剩余的 API 信用
API 密钥管理:生成新的 API 密钥
高精度:B2B电子邮件验证准确率超过99%
Catch-All 域名支持:验证其他工具无法处理的 catch-all 电子邮件域名
防火墙导航:绕过 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-server使用 uv 安装依赖项:
uv sync设置您的 RevenueBase 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 API 的 HTTP 错误会使用requests.raise_for_status()自动引发。
要求
Python 3.7+
fastmcp
请求
执照
该项目根据 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