MCP Server

Model Context Protocol (MCP) - это открытый протокол от Anthropic, который позволяет ИИ-моделям безопасно взаимодействовать с внешними инструментами и источниками данных. BillionVerify предоставляет возможности верификации email корпоративного уровня для ИИ-агентов через HTTP Streamable Transport, делая интеграцию невероятно простой.

Почему ИИ-агентам нужна верификация email

Современные случаи использования ИИ-агентов включают:

• Claude Code нужно верифицировать email-адреса при обработке данных пользователей
• OpenCode требует валидации email в автоматизированных рабочих процессах
• Gemini CLI агентам нужна гарантия качества при работе с регистрационными данными
• Codex сгенерированному коду нужна встроенная логика верификации email
• Пользовательские ИИ-агенты должны подтверждать подлинность контактов при взаимодействии с людьми

BillionVerify MCP позволяет любому ИИ-агенту напрямую вызывать сервисы верификации email корпоративного уровня через стандарт HTTP Streamable Transport - без сложной конфигурации.

Основные возможности

1. Верификация одного email в реальном времени

• Проверка формата email, домена и MX-записей
• Опциональная проверка SMTP-соединения
• Обнаружение временных email
• Идентификация корпоративных vs бесплатных email
• Обнаружение ролевых email (support@, noreply@ и т.д.)
• Среднее время ответа < 2 секунд

2. Пакетная верификация email

• Верификация до 50 email за раз
• Параллельная обработка для эффективности
• Подробные результаты и статистика

3. Умная система кеширования

• Валидные email кешируются на 7 дней
• Невалидные email кешируются на 7 дней
• Неизвестный статус кешируется на 10 минут
• Уменьшает ненужные повторные верификации

4. Точная тарификация кредитов

• Валидный email: 1 кредит
• Невалидный email: 0 кредитов (предотвращает растрату)
• Неизвестный статус: 0 кредитов (автоповтор)
• Запросы баланса в реальном времени

Поддерживаемые ИИ-клиенты

Быстрая настройка (HTTP Transport - Рекомендуется)

Самый простой способ интеграции - без установки npm-пакетов!

Шаг 1: Получите API-ключ

Посетите Панель управления BillionVerify, чтобы создать ваш API-ключ.

Шаг 2: Настройте Claude Desktop

Отредактируйте файл конфигурации:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "billionverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"]
    }
  }
}

Замените YOUR_API_KEY на ваш реальный API-ключ, затем перезапустите Claude Desktop.

Вот и всё! Без npm install, без зависимостей. curl предустановлен на всех системах. Claude теперь имеет возможности верификации email.

Шаг 3: Начните верификацию

В вашем диалоге просто попросите:

Пожалуйста, проверь этот email: user@example.com

Claude автоматически вызовет BillionVerify и вернёт подробные результаты.

Настройка Claude Code

Для Claude Code CLI добавьте MCP-сервер:

claude mcp add billionverify -- curl --stdio "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"

Или добавьте в ваш ~/.claude.json:

{
  "mcpServers": {
    "billionverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"]
    }
  }
}

Настройка OpenCode

Для OpenCode настройте в вашем ~/.opencode/config.json:

{
  "mcpServers": {
    "billionverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"]
    }
  }
}

Настройка Gemini CLI

Для Gemini CLI добавьте в вашу конфигурацию:

{
  "mcpServers": {
    "billionverify": {
      "command": "curl",
      "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"]
    }
  }
}

Настройка Cursor

В Cursor перейдите в Settings > MCP и добавьте:

{
  "billionverify": {
    "command": "curl",
    "args": ["--stdio", "https://mcp.billionverify.com/mcp?api_key=YOUR_API_KEY"]
  }
}

Метод NPX (Альтернативный)

Если вы предпочитаете npm-пакет:

{
  "mcpServers": {
    "billionverify": {
      "command": "npx",
      "args": ["-y", "@billionverify/mcp-server"],
      "env": {
        "BV_API_KEY": "your-api-key-here"
      }
    }
  }
}

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

verify_single_email

Верификация одного email-адреса с комплексной валидацией.

Параметры:

Возвращает:

{
  "email": "user@example.com",
  "status": "valid",
  "score": 1,
  "is_deliverable": true,
  "is_disposable": false,
  "is_catchall": false,
  "is_role": false,
  "is_free": true,
  "domain": "example.com",
  "mx_records": ["has_mx_records"],
  "smtp_check": true,
  "response_time": 2,
  "credits_used": 1
}

Пример использования в Claude:

"Проверь, является ли test@example.com действительным email"

verify_batch_emails

Верификация нескольких email-адресов за раз (макс. 50).

Параметры:

Возвращает:

{
  "total_emails": 2,
  "valid_emails": 2,
  "invalid_emails": 0,
  "results": [...],
  "credits_used": 2,
  "process_time": 4
}

Пример использования в Claude:

"Проверь эти email: user1@example.com, user2@test.com, info@company.com"

get_account_balance

Проверка кредитов аккаунта и статистики использования.

Параметры: Нет

Возвращает:

{
  "account_id": "acc_xxx",
  "credits_balance": 842740,
  "credits_consumed": 157260,
  "credits_added": 1000000,
  "last_updated": "2026-02-05T04:51:35Z"
}

Пример использования в Claude:

"Сколько у меня осталось кредитов на верификацию?"

health_check

Проверка состояния здоровья MCP-сервера.

Параметры: Нет

Возвращает:

{
  "status": "healthy",
  "version": "2.1.0",
  "service": "billionverify-mcp",
  "mode": "api-proxy"
}

get_task_status

Запрос прогресса задачи верификации файла.

Параметры:

Возвращает:

{
  "job_id": "job-uuid-xxxxx",
  "status": "completed",
  "progress": 100,
  "total_emails": 1000,
  "processed_emails": 1000,
  "valid_count": 850,
  "invalid_count": 100
}

Пример использования в Claude:

"Какой статус моей задачи верификации файла job-123?"

get_download_url

Получение ссылки для скачивания результатов верификации с опциональными фильтрами статуса.

Параметры:

Пример использования в Claude:

"Получить ссылку для скачивания только валидных email из job-123"

create_webhook

Создание вебхука для получения уведомлений о завершении верификации.

Параметры:

Возвращает:

{
  "id": "webhook-uuid",
  "url": "https://your-server.com/webhook",
  "events": ["file.completed"],
  "secret": "hmac-secret-for-signature",
  "is_active": true
}

Примечание: secret возвращается только один раз при создании. Сохраните его для верификации подписи.

Пример использования в Claude:

"Создай вебхук, чтобы уведомить меня, когда верификация файла завершится"

list_webhooks

Список всех вебхуков текущего аккаунта.

Параметры: Нет

Возвращает:

{
  "total": 1,
  "webhooks": [
    {
      "id": "webhook-uuid",
      "url": "https://your-server.com/webhook",
      "events": ["file.completed"],
      "is_active": true
    }
  ]
}

Пример использования в Claude:

"Покажи все мои настроенные вебхуки"

delete_webhook

Удаление конкретного вебхука.

Параметры:

Пример использования в Claude:

"Удали вебхук с ID webhook-123"

Примеры использования

Базовая верификация

Пользователь:

Проверь john@google.com

Claude:

Я проверю этот email-адрес для вас.

Результат верификации email

Поле	Значение
Email	john@google.com
Статус	Действителен
Доставляемый	Да
Временный	Нет
Оценка	0.95

Этот email выглядит действительным и доставляемым.

Верификация нескольких email

Пользователь:

Проверь эти email: john@google.com, test@mailinator.com, support@microsoft.com

Claude:

Я проверю все три email-адреса.

Email	Статус	Примечания
john@google.com	Действителен	Доставляемый, корпоративный email
test@mailinator.com	Недействителен	Временный email, рекомендую отклонить
support@microsoft.com	Действителен	Ролевой адрес, может быть общим

Рекомендации:

• john@google.com - Безопасен для использования
• test@mailinator.com - Временный email, не рекомендуется
• support@microsoft.com - Действителен, но вероятно общий ящик команды

Рабочий процесс разработчика

Пользователь (в Claude Code):

Проверь тестовые email в моем файле .env.example

Claude:

Прочитаю файл и проверю найденные email-адреса.

Найдено 3 email-адреса в .env.example:

• TEST_EMAIL=user@example.com
• ADMIN_EMAIL=admin@company.com
• SUPPORT_EMAIL=help@temp-mail.org

Результаты верификации:

Email	Статус
user@example.com	Неизвестен (пример домена)
admin@company.com	Действителен
help@temp-mail.org	Недействителен (временный)

Рассмотрите использование реальных email-адресов для тестирования.

Формат вывода

MCP-сервер возвращает хорошо отформатированные результаты:

## Результат верификации email

**Email:** test@example.com
**Статус:** ДЕЙСТВИТЕЛЕН
**Оценка уверенности:** 95.0%

### Детали
| Проверка | Результат |
|----------|-----------|
| Доставляемый | Да |
| Валидный формат | Да |
| Валидный домен | Да |
| Валидный MX | Да |
| Временный | Нет |
| Ролевой адрес | Нет |
| Catch-all | Нет |
| Бесплатный провайдер | Нет |

**Использовано кредитов:** 1

Лучшие практики

1. Храните API-ключ безопасно

Никогда не хардкодьте ваш API-ключ. Используйте переменные окружения:

{
  "env": {
    "BV_API_KEY": "${BV_API_KEY}"
  }
}

2. Используйте естественный язык

MCP-сервер понимает различные формулировки:

• "Проверь user@example.com"
• "Является ли test@company.com действительным email?"
• "Проверь, доставляемый ли этот email: john@test.com"
• "Можешь проверить эти email-адреса для меня?"

3. Группируйте, когда возможно

Для нескольких email попросите Claude проверить их вместе для эффективности:

"Проверь все эти email сразу: email1@test.com, email2@test.com, email3@test.com"

Устранение неполадок

MCP-сервер не найден

Если Claude говорит, что не может найти инструмент BillionVerify:

1. Проверьте путь к файлу конфигурации
2. Убедитесь, что JSON валиден
3. Полностью перезапустите Claude Desktop
4. Проверьте, что ваш API-ключ корректен

Ошибки лимита запросов

Если вы видите ошибки лимита запросов:

1. Проверьте оставшиеся кредиты вопросом "Сколько у меня кредитов?"
2. Подождите немного и попробуйте снова
3. Рассмотрите обновление плана для более высоких лимитов

Проблемы с подключением

Если верификация не удается:

1. Проверьте ваше интернет-соединение
2. Убедитесь, что ваш API-ключ действителен
3. Попробуйте сначала простую верификацию

FAQ

Безопасен ли мой API-ключ?

Да. API-ключ хранится в вашем локальном файле конфигурации и используется только MCP-сервером, работающим на вашей машине. Он никогда не отправляется третьим сторонам.

Какие ИИ-клиенты поддерживают MCP?

Работает любой MCP-совместимый клиент, включая Claude Desktop, Claude Code, Cursor, Zed, Cline и Continue.

Что происходит при отсутствии сети?

Если API BillionVerify недоступен, инструмент возвращает сообщение об ошибке. Это не влияет на другие возможности Claude.

Как работают кредиты?

Каждая верификация email использует 1 кредит. Массовые верификации используют 1 кредит на email. Проверьте баланс с помощью инструмента check_credits.

Следующие шаги