Revenuebase-mcp-сервер

Сервер MCP RevenueBase

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

Функции

Проверка электронной почты в режиме реального времени : мгновенная проверка отдельных адресов электронной почты.
Пакетная обработка электронной почты : отправка и обработка больших списков адресов электронной почты.
Управление процессами : мониторинг, отмена и отслеживание заданий пакетной обработки.
Управление кредитами : проверка оставшихся кредитов API
Управление ключами API : генерация новых ключей API
Высокая точность : точность более 99% для проверки электронной почты B2B
Поддержка доменов Catch-All : проверка доменов электронной почты Catch-All, которые не могут обрабатываться другими инструментами.
Навигация по брандмауэру : обход брандмауэров электронной почты, таких как Mimecast и Barracuda

О RevenueBase

RevenueBase предоставляет ведущие в отрасли услуги проверки электронной почты, специально разработанные для поставщиков данных B2B. Благодаря возможности проверки доменов catch-all и защищенных брандмауэром, RevenueBase обеспечивает максимальную точность там, где другие сервисы не справляются.

Узнайте больше об услугах проверки электронной почты RevenueBase по адресу: https://revenuebase.ai/email-list-cleaning/

Установка

Клонируйте этот репозиторий:

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

Установите зависимости с помощью uv:

uv sync

Настройте свой ключ 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 можно найти на сайте:

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

revenuebase-mcp-server

Сервер MCP RevenueBase

Функции

О RevenueBase

Установка

Использование

Запуск сервера

Использование с клиентами MCP

Клод Десктоп

Другие клиенты MCP

Доступные инструменты

1. Проверка электронной почты в режиме реального времени

2. Пакетная отправка электронных писем

3. Статус пакетного процесса

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

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

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

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

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

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

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

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

Требования

Лицензия

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

Related MCP Servers

salesforce-mcp

mcp-server-docy

Salesforce MCP

Shopify MCP Server

New MCP Servers

MCP directory API