lookup_phone
Принимает phone и необязательный default_region. Возвращает нормализацию номера, справочную географию, оператора диапазона и местное время.
Инструменты для AI-клиентов
MCP-сервер для AI: данные телефона, GeoIP и распознавание документов
Подключите инструменты ibop к совместимому AI-клиенту через Streamable HTTP. Получайте справочные данные из API, а не предположения языковой модели.
Гостевой MCP: по 100 Phone и GeoIP запросов в календарный месяц на сетевой IP.
Пять инструментов MCP ibop
lookup_ip
Принимает ip в формате IPv4 или IPv6. Возвращает приблизительную географию сети, ASN, провайдера и часовой пояс.
recognize_document
Принимает image_base64: JPEG/PNG до 10 МиБ без префикса data:. Нужны API-ключ и HTTP-заголовок Idempotency-Key. Возвращает ID OCR-задания.
get_document_job
Принимает job_id и возвращает состояние вашего OCR-задания. Опрос не расходует дополнительные распознавания; срок результата — 24 часа.
get_pricing
Возвращает актуальные цены, квоты и ссылки на регистрацию и тарифы. Чтение бесплатно и не создаёт заказ или списание.
Транспорт использует POST и JSON-RPC 2.0 с JSON-ответами. OAuth и SSE сейчас не поддерживаются. Phone возвращает географию диапазона номера, GeoIP — приблизительную географию сети, OCR не проверяет подлинность документа.
Проверьте данные перед подключением MCP
Реальный ответ сервиса без API-ключа. Для интеграции создайте свой ключ в кабинете.
Ответ APIJSON
Ответ появится здесь
Как подключить MCP-сервер к AI-клиенту
Клиент должен поддерживать прямое подключение MCP по Streamable HTTP и, для авторизованных запросов, возможность задать Bearer-заголовок. Формат настроек зависит от клиента; ниже показаны URL и пример структуры подключения.
- Укажите URL https://api.ibop.ru/mcp и транспорт Streamable HTTP.
- Для гостевого Phone/GeoIP начните без ключа. Для OCR и квот аккаунта создайте ключ в кабинете через MAX.
- Добавьте Authorization: Bearer YOUR_API_KEY в настройки HTTP-заголовков клиента и разрешите нужные инструменты.
URL и конфигурация MCP
{
"mcpServers": {
"ibop": {
"url": "https://api.ibop.ru/mcp"
}
}
}Для авторизованного подключения добавьте HTTP-заголовок Authorization: Bearer YOUR_API_KEY средствами своего клиента. Инициализацию и вызов инструментов выполняет MCP-клиент. OAuth и SSE не поддерживаются.
Тарифы API для MCP
Цены и квоты загружаются из действующего каталога API.
Phone API
Бесплатно
0 ₽/ месяц
100запросов
Получить API-ключСтарт
299 ₽/ месяц
10 000запросов
Выбрать тарифПро
990 ₽/ месяц
100 000запросов
Выбрать тарифGeoIP API
Бесплатно
0 ₽/ месяц
100запросов
Получить API-ключСтарт
299 ₽/ месяц
10 000запросов
Выбрать тарифПро
990 ₽/ месяц
100 000запросов
Выбрать тарифOCR API
Бесплатно
0 ₽разовый пакет
10распознаваний
Получить API-ключСтарт
390 ₽/ месяц
1 000распознаваний
Выбрать тарифПро
2 900 ₽/ месяц
10 000распознаваний
Выбрать тарифREST API и авторизованный MCP используют общие квоты аккаунта по каждому продукту. Бесплатный месяц считается по московскому времени. Платный период начинается после подтверждения оплаты. Заказ сам по себе не активирует пакет; оплата подтверждается вручную, автоматических списаний нет.
Вопросы о MCP для AI
Нужна ли регистрация для MCP?
Phone и GeoIP доступны в гостевом режиме. Гостевая квота считается по наблюдаемому сервером сетевому IP; пользователи за одним NAT или AI-шлюзом делят её. Для OCR и квот аккаунта нужен API-ключ.
REST API и MCP расходуют разные пакеты?
Авторизованный MCP и REST используют общие квоты соответствующего продукта в одном аккаунте. Новый MCP-сеанс не сбрасывает расход. Ошибка переданного ключа не переключает запрос на гостевой доступ.
Можно ли подключиться через OAuth или SSE?
В текущей реализации доступны Streamable HTTP и вручную заданный Bearer API-ключ. Клиенты, которым обязательно нужен OAuth или SSE, не поддерживаются.
Для чего нужны llms.txt и mcp.json?
llms.txt описывает инструменты и ограничения, а /.well-known/mcp.json содержит актуальные метаданные подключения. Этот JSON — вспомогательный формат проекта; он не гарантирует автоматическую регистрацию во всех AI-клиентах.