MCP-сервер uChecker

uChecker поддерживает Model Context Protocol открытый стандарт подключения инструментов к AI-агентам. Добавьте наш MCP-сервер в Claude Code, Cursor или любой другой MCP-совместимый клиент, и агент сможет проверять email-адреса, следить за прогрессом задач и выгружать чистые списки, не написав ни строчки кода под REST API.

Подключение

Endpoint: https://api.uchecker.net/mcp (streamable HTTP). Аутентификация идёт по вашему API-ключу в заголовке x-api-key. Ключ находится в личном кабинете.

Claude Code (CLI):

claude mcp add --transport http uchecker https://api.uchecker.net/mcp \
  --header "x-api-key: uk_ВАШ_КЛЮЧ"

Cursor, VS Code и другие клиенты (JSON-конфиг):

{
  "mcpServers": {
    "uchecker": {
      "type": "http",
      "url": "https://api.uchecker.net/mcp",
      "headers": { "x-api-key": "uk_ВАШ_КЛЮЧ" }
    }
  }
}

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

validate_email	Проверить один email-адрес
validate_emails	Пакетная проверка списка (до 10 000 за вызов)
wait_for_task	Дождаться завершения проверки
get_task_status	Статус и прогресс задачи
get_task_results	Постраничные результаты с фильтром good/bad
get_task_analytics	Доставляемость и причины отклонений
export_results	Выгрузка результатов (CSV, списки good/bad)
list_tasks	История задач
get_account_balance	Баланс кредитов
get_account_stats	Сводная статистика аккаунта

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

Попросите агента: «Проверь email-адреса из файла subscribers.csv и сохрани валидные в clean.txt». Агент сам вызовет validate_emails, дождётся завершения через wait_for_task и выгрузит чистый список через export_results. Тарификация та же, что и в API: 1 email = 1 кредит, невалидный синтаксис не тарифицируется.

Зачем агенту валидация

У языковой модели нет способа отличить существующий адрес от выдуманного: ivan@exampel.com выглядит ровно так же правдоподобно, как ivan@example.com. Поэтому агент, который собирает контакты, парсит переписку или заполняет CRM, стабильно приносит мусор, будь то опечатки в домене, одноразовые ящики, ролевые адреса вида info@, спам-ловушки.

MCP-сервер закрывает этот разрыв: агент вызывает проверку и получает не догадку, а результат SMTP-верификации, состояние MX-записей и признак одноразового домена. Дальше он может сам решить, записывать контакт в базу или запросить уточнение.

Где это применяют

Три сценария встречаются чаще прочих. Первый это обогащение CRM: агент проходит по свежим лидам и помечает те, куда писать бессмысленно, до того как менеджер потратит на них время. Второй это разбор входящих заявок, когда адрес введён руками и опечатка в домене означает потерянного клиента. Третий это подготовка рассылки, где проверка идёт пакетом и отсекает мёртвые адреса раньше, чем они испортят репутацию отправителя.

Что возвращает проверка

Ответ не сводится к «валиден / не валиден», потому что такой ответ агенту бесполезен, потому что не подсказывает, что делать дальше. Вместо этого возвращается разложенный результат: прошла ли синтаксическая проверка, есть ли у домена MX-записи, что ответил почтовый сервер на SMTP-проверку конкретного ящика, не является ли домен одноразовым или catch-all, не выглядит ли адрес ролевым.

Различие важно на практике. Адрес на catch-all домене формально подтверждается сервером, но ящика за ним может не быть, и такой контакт стоит записать с пометкой, а не отбросить. Ролевой адрес support@ существует, но писать на него холодное письмо бессмысленно. Одноразовый ящик существует прямо сейчас и перестанет через час.

Ограничения, о которых стоит знать

SMTP-проверка это диалог с почтовым сервером получателя, поэтому она занимает время и упирается в ограничения принимающей стороны. Крупные провайдеры применяют greylisting и лимиты на число запросов с одного адреса, и часть ответов приходит с задержкой или как «неопределённо». Для агента это означает, что проверку разумнее ставить в фоновую задачу, а не в синхронный шаг диалога с пользователем.

REST API

Для прямой интеграции без MCP используйте наш REST API, интерактивная документация доступна на api.uchecker.net/docs.