EmailCheckPro Справочник MCP

Model Context Protocol позволяет AI-приложениям вызывать внешние инструменты во время разговора. Попросите ассистента проверить адрес email или пакет адресов — без написания отдельной интеграции с API.

MCP — это адаптер протокола. Он использует те же продукты, баланс, тарификацию, лимиты параллельности, тайм-ауты и семантику результатов, что и REST API.

Продукты, цены и лимиты описаны в справочнике API

Аутентификация

Используйте тот же ключ API, что и для REST API, и добавьте его как Bearer-токен в конфигурацию MCP-клиента.

Заголовок Authorization
Authorization: Bearer YOUR_API_KEY

Храните ключ API в тайнеДобавляйте ключ только в конфигурацию собственного доверенного клиента. Никогда не раскрывайте его в браузерном коде или публичных промптах.

URL сервера

Укажите в клиенте официальный эндпоинт Streamable HTTP. Локальный процесс MCP не требуется.

ПараметрЗначение
Эндпоинт MCPhttps://emailcheckpro.com/mcp
Streamable HTTPЗапросы используют JSON-RPC поверх Streamable HTTP и то же промежуточное ПО проверки ключа API, что и REST.

Подключите клиент

Выберите формат конфигурации, который поддерживает ваш клиент. Замените заполнитель своим ключом API.

claude mcp add --transport http emailcheckpro https://emailcheckpro.com/mcp --header "Authorization: Bearer YOUR_API_KEY"

Добавьте удалённый сервер из терминала.

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

Инструменты ограничены приложением, которому принадлежит ваш ключ API. Сначала вызовите list_products, если нужно узнать допустимые коды продуктов.

list_products

Выводит список продуктов, цен, множителей тарификации и полей ответа.

Параметры
Без параметров

check_number

Синхронно проверяет один адрес email. Основной результат — registered.

Параметры
service_type · string · обязательный
identifier · string · обязательный

check_numbers

Проверяет от 1 до 100 адресов email с одним service_type и сохраняет порядок ввода.

Параметры
service_type · string · обязательный
identifiers · string[] · обязательный · макс. 100

get_balance

Считывает текущий баланс аккаунта без списания.

Параметры
Без параметров

Примеры запросов

После подключения обращайтесь к ассистенту обычным языком:

  • Проверь, доставляем ли адрес name@example.com — может ли он принимать почту.
  • Проверь эти 20 адресов email и кратко опиши результаты.
  • Сколько осталось на балансе перед запуском этого списка?

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

Ошибки инструментов используют isError=true и тот же контракт code, msg, data, что и API.

Пример ошибки инструмента

{
  "code": 42901,
  "msg": "too many concurrent requests",
  "data": null
}
КодОписание
40000Недопустимый продукт или полеНеподдерживаемый service_type или конфликтующие поля.
40002Неверный адрес emailОтправленный адрес email имеет неверный формат.
40100Ключ API отсутствует или недействителенПроверьте заголовок Bearer и убедитесь, что ключ активен.
40200Недостаточно средств на балансеЗапрос отклоняется до обработки, если баланса не хватает на всю сумму пакета.
42200Не определеноСейчас не удаётся определить статус адреса. Результат не возвращается, и этот вызов не оплачивается.
42901Лимит параллельности исчерпанВсе пять слотов одновременных запросов заняты, или в этом аккаунте уже выполняется множественная проверка. Списания нет; повторите попытку, когда один из запросов завершится.
50303Сервис на пределе мощностиНа платформе выполняется слишком много проверок. Списания нет; подождите указанное в Retry-After число секунд и отправьте запрос повторно.
50400Превышено время проверкиПроверка не завершилась вовремя. Списания нет; множественная проверка, превысившая время, завершается ошибкой целиком, и сумма возвращается полностью.
50300Техобслуживание сервисаПовторите попытку позже.