Сервер MCP RevenueBase

Сервер Model Context Protocol (MCP), который обеспечивает доступ к ведущему в отрасли API проверки электронной почты RevenueBase. Этот сервер позволяет помощникам и приложениям ИИ проверять деловые электронные письма, включая домены catch-all и защищенные брандмауэром, с точностью более 99%.

Функции

• Проверка электронной почты в режиме реального времени : мгновенная проверка отдельных адресов электронной почты.

• Пакетная обработка электронной почты : отправка и обработка больших списков адресов электронной почты.

• Управление процессами : мониторинг, отмена и отслеживание заданий пакетной обработки.

• Управление кредитами : проверка оставшихся кредитов API

• Управление ключами API : генерация новых ключей API

• Высокая точность : точность более 99% для проверки электронной почты B2B

• Поддержка доменов Catch-All : проверка доменов электронной почты Catch-All, которые не могут обрабатываться другими инструментами.

• Навигация по брандмауэру : обход брандмауэров электронной почты, таких как Mimecast и Barracuda

Related MCP server: json-mcp-server

О RevenueBase

RevenueBase предоставляет ведущие в отрасли услуги проверки электронной почты, специально разработанные для поставщиков данных B2B. Благодаря возможности проверки доменов catch-all и защищенных брандмауэром, 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. Настройте свой ключ API RevenueBase:

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 — фактическим ключом API RevenueBase.

Другие клиенты 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): идентификатор задания пакетной обработки.

Пример:

batch_process_email_status(12345)

4. Очередь процессов

Вывести список всех поставленных в очередь заданий по пакетной обработке электронной почты.

Пример:

queued_process()

5. Отменить процесс

Отменить текущую или поставленную в очередь задачу пакетной обработки электронной почты.

Параметры:

• process_id (int): идентификатор процесса, который нужно отменить.

Пример:

cancel_process(12345)

6. Получите кредиты

Узнайте количество оставшихся кредитов на вашем счете.

Пример:

get_credits()

7. Сгенерируйте новый ключ API

Сгенерируйте и верните новый ключ API.

Пример:

new_api_key()

Конфигурация

Переменные среды

• REVENUEBASE_API_KEY : Ваш ключ API RevenueBase (обязательно)

Конечные точки API

Сервер подключается к следующим конечным точкам API RevenueBase:

• 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

Обработка ошибок

Все инструменты включают правильную обработку ошибок и вызывают RuntimeError , если ключ API не настроен. Ошибки HTTP из API RevenueBase автоматически вызываются с помощью requests.raise_for_status() .

Требования

• Питон 3.7+

• fastmcp

• запросы

Лицензия

Данный проект лицензирован по лицензии MIT — подробности см. в файле LICENSE .

Поддерживать

Поддержку и документацию по API RevenueBase можно найти на сайте:

• Подтверждение адреса электронной почты RevenueBase

• Документация API RevenueBase

Если у вас возникли проблемы с этим сервером MCP, пожалуйста, создайте проблему в этом репозитории.