Справочник
EmailCheckPro Справочник MCP
Model Context Protocol позволяет AI-приложениям вызывать внешние инструменты во время разговора. Попросите ассистента проверить адрес email или пакет адресов — без написания отдельной интеграции с API.
MCP — это адаптер протокола. Он использует те же продукты, баланс, тарификацию, лимиты параллельности, тайм-ауты и семантику результатов, что и REST API.
Аутентификация
Используйте тот же ключ API, что и для REST API, и добавьте его как Bearer-токен в конфигурацию MCP-клиента.
Authorization: Bearer YOUR_API_KEYХраните ключ API в тайнеДобавляйте ключ только в конфигурацию собственного доверенного клиента. Никогда не раскрывайте его в браузерном коде или публичных промптах.
URL сервера
Укажите в клиенте официальный эндпоинт Streamable HTTP. Локальный процесс MCP не требуется.
| Параметр | Значение |
|---|---|
| Эндпоинт MCP | https://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[] · обязательный · макс. 100get_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Техобслуживание сервиса | Повторите попытку позже. |