CarrierLookup Справочник 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://carrierlookup.online/mcp
Streamable HTTPЗапросы используют JSON-RPC поверх Streamable HTTP и тот же промежуточный слой проверки ключа API, что и REST.

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

Выберите формат конфигурации, который поддерживает ваш клиент. Замените заглушку своим ключом API.

claude mcp add --transport http carrierlookup https://carrierlookup.online/mcp --header "Authorization: Bearer YOUR_API_KEY"

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

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

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

list_products

Выводит список продуктов, цен, множителей тарификации и полей ответа.

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

check_number

Синхронно определяет оператора одного номера. Поля оператора на верхнем уровне результата — основной ответ.

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

check_numbers

Проверяет от 1 до 100 номеров с одним service_type и сохраняет порядок ввода.

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

get_balance

Получает текущий баланс аккаунта без списания.

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

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

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

  • Узнай, какому оператору изначально был выделен номер +17253100591.
  • Проверь эти 20 номеров и подведи итог по результатам.
  • Сколько осталось на балансе перед запуском этого списка?

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

Ошибки инструментов возвращаются с 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Техобслуживание сервисаПовторите попытку позже.