RevenueBase MCP 服务器

一个模型上下文协议 (MCP) 服务器，提供对 RevenueBase 业界领先的电子邮件验证 API 的访问。该服务器使 AI 助手和应用程序能够验证企业电子邮件，包括全域邮件和受防火墙保护的域名，准确率超过 99%。

特征

• 实时电子邮件验证：立即验证个人电子邮件地址

• 批量电子邮件处理：提交和处理大量电子邮件列表

• 流程管理：监控、取消和跟踪批处理作业

• 信用管理：检查剩余的 API 信用

• API 密钥管理：生成新的 API 密钥

• 高精度：B2B电子邮件验证准确率超过99%

• Catch-All 域名支持：验证其他工具无法处理的 catch-all 电子邮件域名

• 防火墙导航：绕过 Mimecast 和 Barracuda 等电子邮件防火墙

Related MCP server: Mercado Livre MCP Server

关于 RevenueBase

RevenueBase 提供业界领先的电子邮件验证服务，专为 B2B 数据提供商打造。RevenueBase 能够验证全域域名和受防火墙保护的域名，从而确保最高准确性，而其他服务则略逊一筹。

详细了解 RevenueBase 的电子邮件验证服务，请访问： https://revenuebase.ai/email-list-cleaning/

安装

1. 克隆此存储库：

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

2. 使用 uv 安装依赖项：

uv sync

3. 设置您的 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 支持和文档，请访问：

• RevenueBase 电子邮件验证

• RevenueBase API 文档

对于此 MCP 服务器的问题，请在此存储库中打开一个问题。