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

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

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

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

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

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

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

list_products

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

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

check_number

Синхронно проверяет один идентификатор. Основной результат — avatar и avatar_url.

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

check_numbers

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

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

get_balance

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

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

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

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

  • Есть ли у +17253100591 аватар в WhatsApp? Дай ссылку на изображение.
  • Проверь эти 20 адресов email на наличие аватаров и кратко опиши результаты.
  • Сколько осталось на балансе перед запуском этого списка?

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

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