Navitel Geo MCP — геосервисы Navitel внутри вашего ИИ-ассистента. Пользователь пишет вопрос обычным языком — модель сама выбирает и вызывает нужные из 24 инструментов: геокодирование и поиск адресов, маршруты, оптимизация объезда, изохроны и зоны доступности, аналитика покрытия, геометрия без запросов, карта. Знать API Navitel или координаты не нужно.
Есть тестовый период — тот же ключ и суточный лимит, что у API Карт Navitel: оформить доступ.
Превращает текстовые адреса в координаты, координаты — в читаемые адреса, а неоднозначные данные — в управляемый список кандидатов с пометкой статуса.
| Инструмент / возможность | Описание |
|---|---|
geocode | поиск адреса по структурированным компонентам (город, улица, дом) — список кандидатов с координатами и полным адресом |
batch_geocode | пакетная обработка до 200 адресов; по каждому отдельный вердикт: точное совпадение, неоднозначность с альтернативами или отсутствие результата |
validate_address | валидация адресных баз: вердикт «валидно / подозрительно / невалидно» и исправленное написание — для автоматической проверки перед отправкой |
reverse_geocode | GPS-координаты точки превращаются в структурированный адрес |
search_places | текстовый поиск объектов вокруг заданной точки: кафе, магазины, аптеки, организации |
search_along_route | поиск объектов вдоль готового маршрута: коридор заданной ширины с ограничением допустимого отклонения по времени или километражу |
Сценарии: очистка клиентских баз, контроль адресов перед отправкой курьеров, подбор объектов «по пути».
Маршрут — не линия на карте, а управляемый объект: с оценками времени, оптимизацией порядка, временными бюджетами и распределением заказов.
| Инструмент / возможность | Описание |
|---|---|
directions | маршрут по 2+ точкам: пешком, велосипед, авто, грузовик; пробки и время выезда; разбивка на сегменты, перечень дорог, оценки времени; геометрия и повороты — по запросу, порциями |
optimize_route | лучший порядок обхода 3+ промежуточных точек и маршрут в этом порядке |
plan_itinerary | планирование тура в рамках временного бюджета с учётом времени в точках и приоритетов; при превышении — вердикт с разбором по сегментам и авто-отбрасывание лишних точек |
distance_matrix | матрица расстояний и времён между многими точками с учётом дорожной обстановки и прогноза |
compare_commutes | сравнение времени в пути из нескольких точек к одной цели — для выбора офиса, склада или точки встречи |
find_meeting_point | точка встречи, одинаково удобная для группы участников с разными способами передвижения |
cluster_points | кластеризация точек доставки по секторам от депо с учётом вместимости; при нехватке транспорта возвращает причину, а не приближённое решение |
Сценарии: ежедневные маршруты служб доставки, планирование визитов, распределение заказов между машинами.
Ответ на вопрос «куда реально можно добраться» — по дорогам, в реальных условиях, а не по прямой.
| Инструмент / возможность | Описание |
|---|---|
isochrone | полигоны территории, достижимой за заданные интервалы времени, для разных способов передвижения; обратный режим — «откуда успеют к вам»; опциональная карта |
point_in_isochrone | проверка, находится ли точка внутри зоны, — вычисление на сервере, 0 запросов |
filter_points_within_isochrone | выборка точек из набора, попадающих в полигон, — тоже 0 запросов |
coverage_gap_analysis | анализ покрытия: участки территории, недоступные из заданных источников за указанное время, с долей непокрытой территории и геометрией каждого пробела |
emergency_coverage_gap | то же, зарегистрированное под отдельным именем для экстренного назначения с нормативом прибытия |
dispatch_selector | выбор ближайшего депо/станции для инцидента, в том числе в режиме emergency; показывает отставание остальных |
match_location_criteria | многокритериальный отбор локаций: пересечение нескольких зон досягаемости от разных точек |
recommend_site | выбор места размещения объекта: сеточный анализ по точкам спроса с весами, конкурентами и порогом преимущества |
Сценарии: размещение складов, магазинов и пунктов выдачи, аудит покрытия логистических сетей, оценка зоны доставки.
Локальные вычисления на сервере: мгновенно, 0 запросов к вендору и без расходования суточного лимита.
| Инструмент / возможность | Описание |
|---|---|
polygon_area | площадь полигона в квадратных метрах, гектарах или квадратных километрах — например, площадь зоны доступности для отчёта |
bearing | азимут — компасное направление из одной точки в другую, в градусах |
Результат — готовый материал для отчёта: не данные в JSON, а карта.
| Инструмент / возможность | Описание |
|---|---|
render_map | отрисовка карты PNG с маркерами, линиями маршрутов и полигонами; подписи на 27 языках, до 1024×1024 px |
route_ref · polygon_ref | повторное использование полученных геометрий по ссылке — без повторной передачи координат; срок жизни ссылки 60 минут |
карта в чате | картинка (по умолчанию), временная публичная ссылка для писем и презентаций и встроенное окно — клиент показывает доступный способ |
partial) и не выдумывает числа — повторите недостающее точечно.«Найди аптеки рядом с Красной площади»
| Инструмент | Запросы к API Карт | Что тратится |
|---|---|---|
geocode | 1 | Красная площадь → координаты |
search_places | 1 | аптеки от этой точки |
| Итого | 2 | |
«Как доехать на машине в Москве от Тверской, 7 до Ленинского проспекта, 39? Покажи на карте»
| Инструмент | Запросы к API Карт | Что тратится |
|---|---|---|
geocode | 2 | оба адреса → координаты |
directions + карта | 17 | маршрут — 1, картинка карты — до 16 тайлов |
| Итого | 19 | |
«Курьер стартует от Тверской, 7, на машине. Пять точек: Никольская, 5 · Пятницкая, 12 · Котельническая набережная, 21 · Смоленская, 10 · Ленинский проспект, 39. На каждой остановке 15 минут. Бюджет — 3 часа, в конце вернуться на точку старта. Успеет? Покажи порядок»
| Инструмент | Запросы к API Карт | Что тратится |
|---|---|---|
geocode | 6 | старт и пять точек → координаты |
plan_itinerary | 3 | матрица (1) + порядок и маршрут (2) |
| Итого | 9 | |
«Куда можно доехать на машине за 15 минут от Тверской, 7? Покажи контур и площадь зоны»
| Инструмент | Запросы к API Карт | Что тратится |
|---|---|---|
geocode | 1 | Тверская, 7 → координаты |
isochrone + карта | 17 | зона — 1, картинка — до 16 тайлов |
polygon_area | 0 | площадь считается на сервере |
| Итого | 18 | |
«У нас три подстанции скорой: Тверская, 7 · Котельническая набережная, 21 · Смоленская, 10. Норматив прибытия на машине — 10 минут. Зона обслуживания — Центральный административный округ. Где самые большие дыры в покрытии?»
| Инструмент | Запросы к API Карт | Что тратится |
|---|---|---|
geocode | 3 | три подстанции → координаты |
emergency_coverage_gap | 3 | по изохроне на каждую базу; полигоны считаются на сервере |
| Итого | 6 | |
«Депо на Тверской, 7. Восемь заказов с весом: Никольская, 5 (3) · Пятницкая, 12 (2) · Котельническая набережная, 21 (4) · Смоленская, 10 (1) · Ленинский проспект, 39 (5) · Тверская, 13 (2) · Кузнецкий Мост, 7 (3) · Лубянская площадь (1). Две машины, вместимость каждой — 11, на машине, после разгрузки вернуться на депо. Распредели заказы и покажи порядок в каждой машине»
| Инструмент | Запросы к API Карт | Что тратится |
|---|---|---|
geocode | 9 | депо и восемь точек → координаты |
cluster_points | 4 | на каждую машину: порядок + маршрут (2 × 2) |
| Итого | 13 | |
Считайте это верхним расходом: фактическое число запросов сервер пишет в sends_used каждого ответа, а отказ до запроса стоит 0.
Настройки → Connectors → Add custom connector → адрес сервера https://mcp.navitel.ru → Connect → вход в аккаунт Navitel (OAuth).
Подключение удалённого MCP-сервера через OAuth: настройки подключений → Add → адрес сервера → вход в аккаунт Navitel.
Админка → Integrations → External Tool Servers → тип MCP (Streamable HTTP), Bearer-ключ организации или OAuth каждому пользователю. Дальше пользователь включает инструменты в чате: + → Integrations → Tools → Navitel.
Ключ всегда передаётся заголовком, никогда — в URL. Клиенты только с SSE или stdio не поддерживаются.
Тот же ключ и суточный лимит, что у API Карт Navitel. Сколько запросов ушло на ответ, сервер пишет в самом ответе. Есть тестовый период.
| Лимит запросов в сутки | Стоимость в год | Стоимость тысячи запросов сверх лимита |
|---|---|---|
| 1 000 | 60 000 ₽ | 60 ₽ |
| 10 000 | 180 000 ₽ | 18 ₽ |
| 25 000 | 300 000 ₽ | 12 ₽ |
| 50 000 | 425 000 ₽ | 9 ₽ |
| 100 000 | 500 000 ₽ | 6 ₽ |
Есть тестовый период — можно попробовать до заключения договора.
Чтобы ответить на вопрос, сервер делает ровно столько запросов к API Карт Navitel, сколько нужно, и пишет их число в самом ответе — поле sends_used. Эти запросы считаются в суточный лимит вашего ключа, как и обычные вызовы API. Если сервер отклонил запрос ещё до обращения к API (неверный параметр, неизвестная ссылка, исчерпанный лимит), расход — 0. Уже отправленные запросы не возвращаются: это обычная модель учёта вендора.
| Инструмент | Среднее число запросов к API Карт |
|---|---|
geocode · reverse_geocode · search_places · distance_matrix · isochrone · compare_commutes · dispatch_selector · coverage_gap_analysis · emergency_coverage_gap · match_location_criteria | 1 |
recommend_site | 1; 2 — если к точкам спроса приложить адреса конкурентов: для сравнения уходит второй такой же замер |
batch_geocode · validate_address | 1 на адрес (до 200) |
search_along_route | 1; 2 — если задать лимит: «рассматривать только места, добавляющие к поездке не более N минут или M метров» |
directions | 1; с оценками времени — больше |
optimize_route | 2 |
plan_itinerary | 3 |
cluster_points | 2 на каждое указанное вами транспортное средство (вместимость и число машин задаёте вы) |
render_map · карта в ответе (include_map) | 4–12 тайлов (максимум 16) плюс запросы базового вызова |
bearing · polygon_area · point_in_isochrone · filter_points_within_isochrone | 0 |
route_ref/polygon_ref — 0 запросов; один и тот же маршрут не считывается дважды (срок ссылки 60 минут).Обычный ответ компактен по умолчанию: координаты и повороты добавляются только по просьбе — это бережёт контекст модели, а не квоту. Пакетная обработка тоже не уменьшает число запросов (1 на адрес), но экономит число вызовов и ответов ассистента.
Открытый протокол, по которому ИИ-агенты вызывают внешние инструменты: сервер сам описывает каждый инструмент, и модель выбирает их без программного кода со стороны клиента. Транспорт Navitel Geo MCP — Streamable HTTP поверх HTTPS.
Тем, что вызывать API может модель — без строчки кода. Сервер сам описывает свои 24 инструмента, и ассистент выбирает их по вопросу обычным языком; программист пишет интеграцию только в REST. При этом ключ, лимиты и геоданные — те же, что у API Карт Navitel.
Любые MCP-клиенты с Streamable HTTP и пользовательскими заголовками: Claude, ChatGPT, Open WebUI, Cursor, VS Code, Claude Code, OpenCode и т. п. Клиенты только с SSE или stdio не поддерживаются.
Нет: Navitel Geo MCP работает как облачный сервер по Streamable HTTP поверх HTTPS — на стороне клиента ничего не устанавливается, агент просто подключается по адресу. Клиентам с stdio или только SSE сервер не подходит.
Нет: все инструменты только читают данные. Перед первым вызовом клиент запрашивает разрешение пользователя.
Только в заголовок запроса (Api-Key или Authorization: Bearer) — никогда в URL и не показывается в ответах; сервис не выдаёт ключ наружу.
401 — нет ключа в заголовке: проверьте конфиг. 403 (access_denied) — ключ истёк или суточный лимит исчерпан, на клиенте эти случаи неразличимы: повтор с тем же ключом ничего не меняет — дождитесь сброса суточного лимита или запросите его увеличение письмом на sales_maps@navitel.ru с темой «Увеличение лимитов».
Ровно столько запросов к API Карт, сколько сервер реально отправил: число написано в ответе (sends_used). Отказ до отправки — 0. Подробная таблица — во вкладке «Расход запросов».
Ответ по умолчанию компактен, чтобы экономить контекст модели. Полная геометрия и пошаговые повороты приходят по просьбе («покажи маршрут на карте», «опиши повороты»).
Да: в ответе есть ссылки route_ref/polygon_ref — карта, коридор и проверка зоны берут геометрию по ссылке. Срок — 60 минут, ссылка принадлежит вашему ключу; после истечения повторите вызов.
Район поиска не ограничен. Назовите город в вопросе или задайте опорную точку ближе.
Срок жизни ссылки — 60 минут. Ссылка не содержит ключа, но открывается у любого, кто её имеет, — не публикуйте её за пределами назначения.
И то и другое: картинка (по умолчанию), временная ссылка и встроенное окно чата — клиент показывает доступный ему способ.
Да. Отправьте запрос через форму для партнёров: navitel.ru/ru/partners/apinavitelmaps — ключ и суточный лимит те же, что у API Карт Navitel.
Navitel Geo MCP — Navitel geo services inside your AI assistant. The user asks in plain language; the model picks and calls the right tools out of 24: geocoding and address search, routes, visit-order optimization, isochrones and reachability zones, coverage analytics, zero-request geometry, and a map. No Navitel API knowledge and no coordinates required.
A trial period is available — the same key and daily limit as the Navitel Map APIs: request access.
Turns text addresses into coordinates, coordinates into readable addresses, and ambiguous data into a managed candidate list with an explicit status.
| Tool / capability | Description |
|---|---|
geocode | geocoding by structured components — city, street, house — a candidate list with coordinates and full addresses |
batch_geocode | batch processing of up to 200 addresses, each with a verdict: exact, ambiguous with alternatives, or no match |
validate_address | address-base validation: valid / suspect / invalid verdict plus corrected spelling for automated pre-dispatch checks |
reverse_geocode | GPS coordinates of a point turn into a structured address |
search_places | text search for places around a pivot: cafés, shops, pharmacies, organizations |
search_along_route | search along a finished route: a corridor of set width with a bound on allowed detour by time or distance |
Use cases: cleaning client databases, checking addresses before dispatch, picking places “on the way”.
A route is a managed object, not a line on the map: time estimates, visit-order optimization, time budgets and load balancing.
| Tool / capability | Description |
|---|---|
directions | route via 2+ points: walking, cycling, car, truck; traffic and departure time; per-segment roads and time estimates; geometry and turn-by-turn on request, paged |
optimize_route | best visiting order for 3+ intermediate stops and the route along it |
plan_itinerary | a tour within a time budget with stop durations and priorities; an overrun returns a per-segment verdict and drops excess stops automatically |
distance_matrix | distance and time matrix across many points, aware of traffic and forecast |
compare_commutes | commute comparison from many origins to one target — picking an office, warehouse or meeting point |
find_meeting_point | a meeting point fair for a group using different modes of transport |
cluster_points | clusters delivery stops by sector from a depot with vehicle capacity; a short fleet gets an explicit reason, never an approximate answer |
Use cases: daily courier routes, visit planning, splitting orders across vehicles.
The answer to “where can you actually get” — along roads, in real conditions, not as the crow flies.
| Tool / capability | Description |
|---|---|
isochrone | polygons reachable within set time intervals per travel mode; reverse mode — who can reach you; optional map |
point_in_isochrone | checks a point against the zone — computed server-side, 0 requests |
filter_points_within_isochrone | keeps the set points that fall inside the polygon — also 0 requests |
coverage_gap_analysis | coverage analysis: areas unreachable from the sources within the time limit, with the uncovered share and each gap's geometry |
emergency_coverage_gap | the same under its own name for emergency response with a time standard |
dispatch_selector | picks the nearest depot/station for an incident, emergency mode included, and reports the lag of the rest |
match_location_criteria | multi-criteria location filter: intersection of reachability zones from several points |
recommend_site | site selection: grid analysis over weighted demand points, competitors and an advantage threshold |
Use cases: siting warehouses, stores and pickup points, auditing network coverage, sizing a delivery zone.
Computed locally on the server: instant, 0 vendor requests, and they never spend the daily allowance.
| Tool / capability | Description |
|---|---|
polygon_area | polygon area in m², hectares or km² — e.g. the reachability zone area for a report |
bearing | bearing — the compass direction from one point to another, in degrees |
The output is report-ready material: not JSON data, but a map.
| Tool / capability | Description |
|---|---|
render_map | renders a PNG map with markers, route lines and polygons; labels in 27 languages, up to 1024×1024 px |
route_ref · polygon_ref | reuses returned geometries by reference — no re-sent coordinates; 60-minute lifetime |
map in chat | image (default), a temporary public link for e-mails and slides, and an embedded window — the client shows what it supports |
partial) and never invents numbers — re-ask the missing piece precisely.“Find pharmacies near Red Square”
| Tool | Map API requests | What it spends |
|---|---|---|
geocode | 1 | Red Square → coordinates |
search_places | 1 | pharmacies from that spot |
| Total | 2 | |
“How do I drive in Moscow from 7 Tverskaya St to 39 Leninsky Prospekt? Show it on a map”
| Tool | Map API requests | What it spends |
|---|---|---|
geocode | 2 | both addresses → coordinates |
directions + карта | 17 | route — 1, map picture — up to 16 tiles |
| Total | 19 | |
“A courier starts at 7 Tverskaya by car. Five stops: 5 Nikolskaya, 12 Pyatnitskaya, 21 Kotelnicheskaya Emb., 10 Smolenskaya, 39 Leninsky Prospekt. 15 minutes at each. Budget — 3 hours, then return to the start. Will it fit? Show the order”
| Tool | Map API requests | What it spends |
|---|---|---|
geocode | 6 | start and five stops → coordinates |
plan_itinerary | 3 | matrix (1) + order and route (2) |
| Total | 9 | |
“What is reachable by car in 15 minutes of 7 Tverskaya? Show the outline and the area”
| Tool | Map API requests | What it spends |
|---|---|---|
geocode | 1 | 7 Tverskaya → coordinates |
isochrone + карта | 17 | zone — 1, picture — up to 16 tiles |
polygon_area | 0 | the area is computed server-side |
| Total | 18 | |
“Three ambulance stations: 7 Tverskaya, 21 Kotelnicheskaya Emb., 10 Smolenskaya. A 10-minute car arrival standard. Service area — the Central District. Where are the biggest coverage gaps?”
| Tool | Map API requests | What it spends |
|---|---|---|
geocode | 3 | three stations → coordinates |
emergency_coverage_gap | 3 | one isochrone per base; polygon maths is server-side |
| Total | 6 | |
“Depot at 7 Tverskaya. Eight weighted orders: 5 Nikolskaya (3) · 12 Pyatnitskaya (2) · 21 Kotelnicheskaya Emb. (4) · 10 Smolenskaya (1) · 39 Leninsky Prospekt (5) · 13 Tverskaya (2) · 7 Kuznetsky Most (3) · Lubyanskaya Sq. (1). Two vans, capacity 11 each, driving, return to the depot after unloading. Assign the orders and show the running order per van”
| Tool | Map API requests | What it spends |
|---|---|---|
geocode | 9 | depot and eight stops → coordinates |
cluster_points | 4 | per van: order + route (2 × 2) |
| Total | 13 | |
Read these as the upper spend: the server states the real count in every answer's sends_used, and a refusal before dispatch costs 0.
Settings → Connectors → Add custom connector → server URL https://mcp.navitel.ru → Connect → Navitel sign-in (OAuth).
A remote MCP connection through OAuth: connector settings → Add → server address → sign in to the Navitel account.
Admin → Integrations → External Tool Servers → type MCP (Streamable HTTP), org Bearer key or per-user OAuth; users then enable tools in chat: + → Integrations → Tools → Navitel.
The key always rides a header, never a URL. SSE-only or stdio clients are not supported.
The same API key and daily limit as for the Navitel Map APIs. The server states in the response itself how many requests were spent on it. A trial period is available.
| Daily request limit | Annual price | Price per 1,000 requests above the limit |
|---|---|---|
| 1 000 | 60 000 ₽ | 60 ₽ |
| 10 000 | 180 000 ₽ | 18 ₽ |
| 25 000 | 300 000 ₽ | 12 ₽ |
| 50 000 | 425 000 ₽ | 9 ₽ |
| 100 000 | 500 000 ₽ | 6 ₽ |
A trial period is available — try it before signing an agreement.
To answer a question the server sends exactly as many Navitel Map API requests as needed and states the number in the answer itself — the sends_used field. They count against the daily limit of your key, just like ordinary API calls. If the server refuses before dispatching (bad parameter, unknown reference, exhausted limit), the cost is 0. Sent requests are never refunded — that is the vendor's standard metering.
| Tool | Average Map API requests |
|---|---|
geocode · reverse_geocode · search_places · distance_matrix · isochrone · compare_commutes · dispatch_selector · coverage_gap_analysis · emergency_coverage_gap · match_location_criteria | 1 |
recommend_site | 1; 2 — a second comparison call is spent when competitor locations are given alongside demand |
batch_geocode · validate_address | 1 per address (up to 200) |
search_along_route | 1; 2 — if you set a bound: “keep only places that add no more than N minutes or M metres to the trip” |
directions | 1; more with time estimates |
optimize_route | 2 |
plan_itinerary | 3 |
cluster_points | 2 per transport in the fleet (you set the vehicle count and capacity) |
render_map · map in the answer (include_map) | 4–12 tiles (max 16) plus the host call |
bearing · polygon_area · point_in_isochrone · filter_points_within_isochrone | 0 |
route_ref/polygon_ref — 0 requests; the same route is never computed twice (60-minute link life).A regular answer is compact by default: coordinates and turn-by-turn attach only on request — that saves the model's context, not quota. Batching does not reduce requests either (1 per address); it saves calls and chat round-trips.
The open protocol by which AI agents call external tools: the server itself describes every tool and the model selects them with no client-side code. Navitel Geo MCP runs on Streamable HTTP over HTTPS.
The model makes the calls — with no code. The server describes its 24 tools and the assistant picks them from a plain-language question; in REST a developer writes the integration instead. The key, the limits and the geodata stay the same Navitel Map API ones.
Any MCP client with Streamable HTTP and custom headers: Claude, ChatGPT, Open WebUI, Cursor, VS Code, Claude Code, OpenCode, etc. SSE-only or stdio clients are not supported.
No: Navitel Geo MCP runs as a cloud server over Streamable HTTP/HTTPS — nothing is installed on the client side; agents just connect to the address. stdio or SSE-only clients are not supported.
No: every tool is read-only. The client asks the user for permission before the first call.
Only into a request header (Api-Key or Authorization: Bearer) — never a URL, never surfaced in answers; the service never echoes the key.
401 — no key in the header: check the config. 403 (access_denied) — expired key or exhausted daily limit, indistinguishable from the client: retrying with the same key changes nothing — wait for the daily reset or request a limit increase by e-mail to sales_maps@navitel.ru with the subject “Limit increase”.
As many Map API requests as the server actually sent: the number is written into the answer (sends_used). A pre-dispatch refusal costs 0. The full table is in the “Request usage” tab.
Answers are compact by default to spare the model's context. Full geometry and turn-by-turn arrive on request (“show the route on a map”, “describe the turns”).
Yes: the answer carries route_ref/polygon_ref — the map, corridor and zone check take the geometry by reference. The life is 60 minutes on your key; after expiry re-run the call.
The search region is not bounded. Name the city in the question or move the pivot closer.
The link lives 60 minutes. It carries no key yet opens for anyone holding it — do not publish it beyond its purpose.
Both: image (by default), the temporary link and the embedded chat window — the client shows whatever it supports.
Yes. Send a request through the partner form: navitel.ru/ru/partners/apinavitelmaps — the same key and daily limit as the Navitel Map APIs.
