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