# uChecker MCP

MCP-сервер для проверки email в сервисе uChecker. AI-агент сам проверяет адреса и списки, ждёт результат и выгружает чистую базу, без написания кода под REST API.

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

Облачный сервер: `https://api.uchecker.net/mcp` (Streamable HTTP)

API-ключ берётся в личном кабинете: https://app.uchecker.net
Ключ передаётся в заголовке `x-api-key` (или `Authorization: Bearer`).

Claude Code:

```
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`: проверить один адрес
- `validate_emails`: проверить список (до 10 000 за вызов)
- `wait_for_task`: дождаться завершения проверки
- `get_task_status`: статус и прогресс задачи
- `get_task_results`: результаты по адресам, с фильтром good/bad
- `get_task_analytics`: доставляемость и причины отказов
- `export_results`: выгрузка результатов
- `list_tasks`: история задач
- `get_account_balance`: остаток кредитов
- `get_account_stats`: статистика аккаунта

## Что важно знать

- Проверка платная: 1 адрес = 1 кредит.
- Проверка идёт в фоне. Сначала возвращается номер задачи, потом результат.
- Каждый адрес получает статус good, bad или unknown. Unknown значит, что вердикта нет (например, greylisting), и это не то же самое, что невалидный адрес.

## Ссылки

- Сайт: https://uchecker.net/mcp
- Репозиторий: https://github.com/uChecker-net/mcp
- Лицензия: MIT