WA Lookup Справочник MCP

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

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

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

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

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

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

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

URL сервера

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

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

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

Поддерживаются Claude Code, Cursor / Claude Desktop и любые другие MCP-клиенты с поддержкой Streamable HTTP. Выберите подходящую вкладку ниже и замените заглушку своим ключом API.

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

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

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

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

list_products

Выводит список продуктов, доступных для этого ключа API, включая цены, множители тарификации, назначение и поля ответа.

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

check_number

Синхронно проверяет один отправленный номер. registered — основной результат; avatar и business — необязательные поля продукта.

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

check_numbers

Проверяет от 1 до 100 номеров с одним service_type. Результаты сохраняют порядок ввода; каждый номер оценивается независимо, и ошибка по одному номеру не останавливает остальные.

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

get_balance

Получает текущий баланс аккаунта. Только чтение: проверка не создаётся, списаний с аккаунта нет.

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

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

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

  • Проверь, зарегистрирован ли +17253100591 в WhatsApp.
  • Проверь эти 20 номеров и подведи итог: сколько зарегистрировано и сколько нет.
  • Покажи продукты, доступные для моего ключа API, и их цены.
  • Сколько осталось на балансе перед запуском этого списка?

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

Ошибки инструментов возвращаются с isError=true, чтобы клиент мог объяснить, что произошло, а не считать соединение разорванным. Бизнес-ошибки используют тот же контракт code, msg, data, что и API.

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

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