app.trustydata/trustydata

Description and use

French address quality, geocoding & routing from official data (BAN, INSEE, OpenStreetMap).

Compatible agents

• Claude Desktop
• Claude Code
• Hermes
• Codex CLI

Capabilities

attribution: Mentions légales à restituer (BAN/INSEE/Filosofi ; SIRENE/INPI/BODACC/OpenDataSoft ; OSM).

compute_route: Calcule un itinéraire routier complet entre une origine et une destination (voiture, France, OpenStreetMap) : distance, durée, étapes de navigation en français, boîte englobante et géométrie encodée. Plan minimum : Business. Mention OSM ODbL obligatoire. Pour de simples distances en masse, préfère route_matrix.

get_address_details: Récupère le détail complet d'une adresse via son identifiant (id renvoyé par search_address ou verify_address). Outil de drill-down : les détails sont déjà inclus inline par les deux autres outils. Plan minimum : Discovery.

get_company_details: Fiche détaillée d'une entreprise ou d'un établissement français (base SIRENE). Un seul identifiant, deux usages : un SIRET (14 chiffres) renvoie la fiche de CET établissement ; un SIREN (9 chiffres) renvoie celle du SIÈGE de l'entreprise. Structure de la réponse : la racine décrit l'ÉTABLISSEMENT (adresse, activité, effectif, état, conventions collectives applicables à CE site) et le bloc unite_legale décrit l'ENTREPRISE (identité, dirigeants, chiffre d'affaires, TVA). Le niveau de détail dépend du plan : géolocalisation et TVA en Starter, dirigeants et conventions collectives en Growth, finances et procédures collectives en Business. Un champ ABSENT n'est pas une donnée inexistante : il peut être hors plan — propose alors la montée de plan plutôt que d'affirmer que la donnée n'existe pas. Les dirigeants sont des données personnelles issues du Registre National des Entreprises (INPI) ; chacun porte opposition_prospection — true = cette personne s'est opposée à l'usage de ses donn

route_matrix: Calcule une matrice de distances et durées entre N origines et M destinations (jusqu'à 25×25), en voiture, sur le réseau France (OpenStreetMap). Sans géométrie. Plan minimum : Growth. Mention OSM ODbL obligatoire.

search_address: Recherche des adresses françaises à partir d'un texte libre (même partiel) et renvoie des candidats classés par pertinence (score 0-1). Pour confirmer UNE adresse précise, préfère verify_address. Chaque candidat porte les trois lignes postales prêtes à écrire (ligne_voie, ligne_complement, ligne_commune). Enrichissements selon le plan (mêmes paliers que verify_address, dont statistical_grid Filosofi en Business). Plan minimum : Discovery.

search_company: Recherche des entreprises et des établissements français dans la base SIRENE (INSEE), par nom, SIREN, SIRET, ville, code postal, code NAF, ou par proximité géographique. IMPORTANT : un résultat est TOUJOURS un ÉTABLISSEMENT (un SIRET), jamais une entreprise — même groupé par entreprise, où le SIREN est représenté par son meilleur établissement (le siège de préférence). Ne dis donc pas « 3 entreprises trouvées » pour 3 établissements d'un même SIREN. Par défaut, un résultat par entreprise si query est fourni, un résultat par établissement en recherche par proximité ou par siren ; force ce comportement avec group_by_company. Lis classement_pertinence avant de présenter un « meilleur match » : à false (listing simple ou tri par distance), le premier résultat n'est PAS le plus probable. Un résultat diffusible: false a ses nom et adresse masqués par l'INSEE — c'est la loi, pas une donnée manquante : ne complète jamais de mémoire. Une liste vide fait autorité : aucune entreprise ne

search_locality: Recherche ET liste des communes françaises. Deux usages : (1) retrouver une commune précise par nom, code postal ou code INSEE (renseigne query) ; (2) LISTER/FILTRER les communes d'un département ou d'une région, avec une fourchette de population optionnelle — query est alors inutile. Exemple : « communes du Pas-de-Calais de plus de 100 000 habitants » → department_code=["62"], population_min=100000. Préfère department_code (ex. "62") au nom ; les noms de département sont normalisés automatiquement ("Pas-de-Calais", "Val-d'Oise"… sont acceptés). Renvoie code INSEE, code postal, population et — selon le plan/details — altitude, densité, surface, département et région. Plan minimum : Discovery.

search_nearby: Recherche les adresses du référentiel officiel (BAN) situées dans un rayon de radius_m mètres (1 à 50 000) autour d'un point central, triées par distance croissante. Le point central est SOIT une adresse libre (address), SOIT un couple lat+lon WGS84 — jamais les deux. Une adresse libre est résolue comme verify_address et renvoyée dans point_central.adresse_resolue. Chaque résultat porte distance_m (mètres, à vol d'oiseau) et les enrichissements du plan (mêmes paliers que verify_address, dont statistical_grid Filosofi en Business). Pagination : passer offset=pagination.next_offset pour charger la page suivante (null = fin de parcours) ; pagination.total_estime est une estimation ; si pagination.tronque vaut true, le cap de 5000 adresses est atteint — réduire le rayon pour l'exhaustivité. Plan minimum : Growth.

verify_address: Vérifie et normalise une adresse postale française contre le référentiel officiel (BAN). Renvoie un verdict (match_exact, match_probable, aucun_match) et l'adresse canonique, déjà découpée en trois lignes postales prêtes à écrire (ligne_voie, ligne_complement, ligne_commune) — à utiliser telles quelles plutôt que de recomposer l'adresse. Selon le plan : coordonnées GPS + Lambert 93 (Starter+), code IRIS (Growth+), statistiques INSEE Filosofi du carreau 200 m dans statistical_grid : population, répartition par tranches d'âge (0-3 à 80+), ménages, pauvreté, niveau de vie, époque de construction des logements (Business). Plan minimum : Discovery. Une adresse par appel.

streamable-http: Transport declared by the upstream MCP registry.

Limitations and review notes

Discovered metadata only; install commands are stored for review but never executed by AtlasRepo.