TrustyData

npx add-mcp 'https://mcp.trustydata.app/mcp'

MCP-сервер TrustyData

Подключите свою LLM (Claude, ChatGPT, IDE-ассистенты…) к TrustyData — качеству адресных данных Франции, геокодированию, маршрутизации, поиску компаний (SIRENE) и статистике зон охвата (INSEE) на основе официальных источников открытых данных (BAN, INSEE, SIRENE, IGN, OpenStreetMap).

▶️ Попробуйте вживую — публичный демо-агент, аккаунт не нужен Попросите реального агента проверить адрес, перечислить коммуны, найти компанию или рассчитать маршрут: он вызывает этот MCP-сервер прямо у вас на глазах.

Это размещённый удалённый MCP-сервер — ничего устанавливать или запускать не нужно. Укажите в своём MCP-клиенте приведённую ниже конечную точку и войдите в аккаунт TrustyData.

Конечная точка	https://mcp.trustydata.app/mcp
Транспорт	Streamable HTTP
Аутентификация	OAuth 2.1 (вход в аккаунт TrustyData)
Документация	https://trustydata.fr/docs/
Статус	https://status.trustydata.app

В этом репозитории размещены метаданные публичного каталога MCP-сервера TrustyData (server.json, документация, примеры). Сам сервер — размещённая служба; исходный код базового API данных не входит в этот репозиторий.

Возможности

TrustyData преобразует неструктурированные французские адреса в чистые, достоверные данные и добавляет географический контекст прямо в диалог с вашей LLM:

• Проверка и нормализация французского почтового адреса по официальному справочнику BAN (результат является достоверным: пустой результат означает, что совпадений нет).
• Поиск адресов и населённых пунктов по названию, почтовому индексу или коду INSEE с необязательными фильтрами (департамент, регион, население).
• Поиск поблизости — поиск адресов или точек рядом с указанным местом.
• Маршрутизация — расчёт автомобильного маршрута или матрицы времени в пути/расстояний во Франции (OpenStreetMap) на автомобиле, пешком или на велосипеде.
• Поиск компаний — поиск французских компаний и предприятий в официальном реестре SIRENE и получение полных записей (руководители, финансы, коллективные соглашения — в зависимости от вашего плана).
• Зоны охвата — население, домохозяйства, доходы, возрастной и социально-профессиональный профиль, потенциал расходов для зоны, заданной временем в пути на автомобиле или радиусом (INSEE Filosofi и перепись населения); сравнение до 10 зон и оценка того, что покрывает исключительно каждая из них.
• Структура видов деятельности — количество предприятий SIRENE в зоне охвата по группам и подгруппам видов деятельности, плотность на 10 000 жителей и индекс относительно эталонной территории: по умолчанию Франции или, если вы попросите, доминирующего департамента зоны. Это нижняя оценка, а не общее число: учитываются только действующие предприятия с географической привязкой; в ответе указано, какой эталон использован и какую долю от него составляет это количество.
• Банкротства и прекращение деятельности — коллективные процедуры, опубликованные в BODACC (ликвидация, конкурсное производство, санация), учитываемые для каждого предприятия компании, расположенного в зоне, а также прекращение деятельности (закрытия в SIRENE, которые не являются ни передачей бизнеса по тому же адресу, ни переездом). Данные представлены по годам начиная с 2017 года и по видам деятельности, с показателем на 100 действующих предприятий и индексом относительно эталонной территории. Число процедур — нижняя оценка, прекращений деятельности — верхняя; данные за текущий год неполные — это указано в ответе.

Более подробные поля (например, статистическая сетка INSEE Filosofi, координаты Lambert 93) возвращаются в зависимости от вашего плана.

Инструменты

Инструмент	Назначение	Минимальный план
verify_address	Проверка и нормализация французского адреса по BAN	Discovery
search_address	Автодополнение / поиск полных адресов	Discovery
get_address_details	Полная информация об адресе по его идентификатору	Discovery
search_locality	Поиск французских коммун / населённых пунктов	Discovery
search_nearby	Поиск поблизости от точки	Growth
route_matrix	Матрица времени в пути / расстояний (автомобиль, пешком, велосипед)	Growth
compute_route	Полный автомобильный маршрут между точками (автомобиль, пешком, велосипед)	Business
search_company	Поиск французских компаний и предприятий в реестре SIRENE (название, SIREN/SIRET, вид деятельности, местоположение)	Discovery (поиск поблизости: Growth)
get_company_details	Полная запись предприятия или компании (идентификационные данные, руководители, финансы, коллективные соглашения — в зависимости от плана)	Discovery
zone_stats	Полная информация о зоне охвата (время в пути на автомобиле или радиус): население, домохозяйства, доходы, возрастной и социально-профессиональный профиль, потенциал расходов, цены продажи недвижимости DVF (динамика за 5 лет, сравнение с департаментом) и количество предприятий по видам деятельности (SIRENE, плотность на 10 000 жителей, индекс относительно Франции или доминирующего департамента), банкротства и прекращение деятельности с 2017 года (BODACC + SIRENE)	Growth или Pass Zones (15 дней, €30 без НДС)
zone_compare	Сравнение 2–10 зон охвата: население, охватываемое исключительно каждой зоной, попарные пересечения, ранжирование — для каждой зоны приводится полный блок zone_stats, включая цены на недвижимость и количество предприятий по видам деятельности, банкротства и прекращение деятельности с 2017 года (BODACC + SIRENE)	Growth или Pass Zones (15 дней, €30 без НДС)

Все инструменты доступны каждому клиенту. Если ваш план не включает нужный инструмент, вместо молчаливого сбоя вы получите понятное сообщение о том, как перейти на другой план.

Промпты

Помимо инструментов, сервер предоставляет пять промптов — готовых сценариев, которые подставляют нужные параметры. В Claude Code они отображаются как /mcp__trustydata__<name>; другие MCP-клиенты показывают их по-своему.

Промпт	Аргументы	Назначение
zone_de_chalandise	adresse, minutes (10), mode (car)	Полный профиль зоны охвата по данным INSEE, включая цены продажи недвижимости и количество предприятий по видам деятельности
comparer_emplacements	adresses (2–10), minutes (10)	Сравнение местоположений с ранжированием по населению, охватываемому исключительно каждой зоной
potentiel_commerce	adresse, secteur, minutes (10), coefficient	Оценка располагаемого дохода и потенциала расходов по секторам
verifier_adresses	adresses	Проверка списка адресов, по одному вызову на каждый адрес
qualifier_entreprise	nom_ou_siret	Поиск компании в SIRENE и открытие её полной записи

Названия и формулировки промптов — на французском языке, как и описываемые ими данные. Промпт возвращает сообщение, а не результат: он сам не вызывает инструменты и не расходует квоту — когда ассистент вызывает указанный инструмент, к нему применяется требование соответствующего плана.

Подключение

Claude (claude.ai / Claude Desktop)

Добавьте пользовательский коннектор, указав:

https://mcp.trustydata.app/mcp

При первом использовании инструмента вам будет предложено войти через OAuth в аккаунт TrustyData.

Универсальный MCP-клиент (Streamable HTTP)

{
  "mcpServers": {
    "trustydata": {
      "url": "https://mcp.trustydata.app/mcp"
    }
  }
}

Ещё нет аккаунта? Начните бесплатно на trustydata.fr — план Discovery бесплатный (20 000 запросов в месяц, банковская карта не требуется).

Примеры запросов (в свободной форме)

Промпт не нужен — просто спросите:

Vérifie et normalise cette adresse : "1 rue de Rivol 75001 Pari"

Quelle est la population de la commune de Bourg-en-Bresse ?

Trouve les adresses proches du 2 avenue de la Gare à Annecy.

Calcule l'itinéraire routier entre Lyon Part-Dieu et l'aéroport Saint-Exupéry.

Trouve les entreprises de plomberie à Annecy et donne-moi la fiche du premier établissement.

Combien de personnes habitent à 15 minutes en voiture du 1 rue Scribe, 75009 Paris, et quel est leur niveau de vie ?

Compare 10 minutes en voiture autour de la Part-Dieu et autour de Bellecour : quelle zone capte le plus d'habitants qu'elle est seule à couvrir ?

Combien d'établissements de restauration y a-t-il à 10 minutes à pied de la place Bellecour, et est-ce beaucoup pour le nombre d'habitants ?

Источники данных и указание авторства

TrustyData использует официальные регулярно обновляемые открытые данные. Сохраняйте указания авторства, возвращаемые инструментами:

• Адреса и коммуны — Base Adresse Nationale (BAN) и INSEE
• Компании — SIRENE (INSEE), Registre National des Entreprises (INPI)
• Статистический контекст и зоны охвата — INSEE Filosofi и перепись населения, IGN Contours IRIS
• Цены продажи недвижимости — DGFiP, Demandes de valeurs foncières (Etalab, открытая лицензия)
• Предприятия по видам деятельности — SIRENE (INSEE), только действующие предприятия с географической привязкой
• Банкротства — BODACC (DILA) и SIRENE (INSEE), только предприятия с географической привязкой
• Маршрутизация — участники OpenStreetMap (ODbL)

Пакет плагина ChatGPT

Каталог plugin-chatgpt/ содержит исходный код плагина TrustyData, отправленного в каталог плагинов ChatGPT (формат Agent Plugins: plugin.json, mcp.json, skills/, assets/). Он подключается к тому же размещённому серверу и не содержит секретов: URL демо-видео добавляется только во время сборки.

python3 plugin-chatgpt/build_zip.py --video <demo recording url> --sortie dist/

Скрипт упаковывает только файлы из списка разрешённых, отклоняет любые посторонние файлы и всё, что похоже на секрет, и создаёт dist/trustydata-plugin-<version>.zip. Загрузите этот ZIP в существующий плагин TrustyData на панели разработчика OpenAI (не создавайте второй плагин). Тесты: pip install -r requirements-dev.txt && pytest.

Документация

Полные руководства по API, справочник конечных точек и примеры: https://trustydata.fr/docs/

Лицензия

Содержимое этого репозитория с материалами для каталога (документация, server.json, примеры) распространяется по лицензии MIT. Размещённая служба и базовый API данных обслуживаются TrustyData и регулируются его условиями.