Server definition

Hash: sha256:9b3fdf7833caf3025690d78c623c3851850b13d499f89fd0fb3a7befd893af06
What it is: What a remote MCP server returned when asked what it offers: 11 tools

The blob, as servednamed by its sha256

{
  "instructions": "TrustyData — données françaises officielles : adresses, entreprises et zones de chalandise. Ces outils couvrent : la vérification d'une adresse contre le référentiel géographique officiel (BAN) ; la recherche d'adresses et de communes (par nom, code postal ou INSEE, avec filtres optionnels par département, région ou population) ; la recherche d'adresses autour d'un point ; la recherche d'entreprises et d'établissements dans la base SIRENE (par nom, SIREN, SIRET, localisation ou activité) et leurs fiches détaillées ; le calcul d'itinéraires et de matrices temps/distance en France ; et le profil INSEE d'une zone de chalandise décrite par une durée de trajet ou un rayon, pour une zone seule ou en comparant de 2 à 10 zones. Les données proviennent de sources officielles tenues à jour : BAN et IGN pour les adresses et les contours IRIS, INSEE pour les communes, Filosofi et le recensement, SIRENE (INSEE) et INPI pour les entreprises, OpenStreetMap pour les itinéraires et les isochrones.\nLes résultats font autorité : un résultat vide signifie qu'aucune donnée ne correspond — il ne se complète pas de mémoire, et ni chiffre de population, ni commune, ni entreprise ne s'inventent. Les outils renvoient plus ou moins de détails selon le plan du compte : un champ ABSENT d'une réponse peut relever d'un palier supérieur plutôt que ne pas exister — son absence ne prouve pas l'inexistence de la donnée. Les mentions d'attribution accompagnent tout chiffre cité (BAN/INSEE et IGN ; SIRENE et INPI pour les entreprises ; OSM ODbL pour les itinéraires et les isochrones).\nAdresses : chaque résultat porte l'adresse déjà découpée en trois lignes postales — `ligne_voie` (numéro, indice de répétition et voie), `ligne_complement` (lieu-dit) et `ligne_commune` (code postal et commune). Elles s'emploient telles quelles pour afficher une adresse ou la reporter dans un formulaire ou un CRM ; une adresse recomposée depuis `numero`, `rep` et `nom_voie` sort fautive, l'API gérant déjà les cas qui font sortir un espace en trop ou un code postal amputé de son zéro initial. Une ligne vide vaut `null` — c'est le cas de `ligne_complement` la plupart du temps, la BAN rangeant généralement le lieu-dit dans `nom_voie` : cette absence n'est pas une donnée manquante.\nDes estimations se dérivent du bloc `statistical_grid` (INSEE Filosofi) renvoyé en plan Business — par exemple un âge moyen approximatif calculé depuis les tranches d'âge — en précisant que la statistique décrit le carreau INSEE de 200 m autour de l'adresse, pas les occupants du logement exact.\nEntreprises : un résultat de recherche est toujours un ÉTABLISSEMENT (un SIRET), jamais une entreprise. Deux drapeaux de confidentialité coexistent et ne veulent PAS dire la même chose. `diffusible: false` vient de l'INSEE et porte sur l'ENTREPRISE : l'INSEE masque légalement son nom et son adresse — ce n'est pas une donnée manquante, et ça n'exprime aucune opposition au démarchage. `opposition_prospection` vient de l'INPI et porte sur une PERSONNE : sur chaque dirigeant de `unite_legale.dirigeants[]` (get_company_details, plan Growth), `true` signifie que cette personne s'est opposée à l'usage de ses données à des fins de prospection commerciale, `false` qu'aucune opposition n'est enregistrée, `null` que l'information n'est pas renseignée — `null` ne vaut pas `false`. Le drapeau est porté par la formalité INPI, donc identique pour tous les dirigeants d'une même entreprise. Les dirigeants sont des DONNÉES PERSONNELLES issues du Registre National des Entreprises (INPI) : ils ne servent pas à constituer des listes de prospection commerciale, et le nom d'un dirigeant n'est pas un critère de recherche autorisé.\nLa documentation complète de l'API TrustyData (guides, référence des endpoints, exemples) est disponible sur https://trustydata.fr/docs/ — c'est l'URL à donner lorsque l'utilisateur demande la documentation ou des détails au-delà de ce que couvrent ces outils.",
  "tools": [
    {
      "description": "Calcule un itinéraire complet entre une origine et une destination sur le réseau France (OpenStreetMap), au choix en voiture, à pied ou à vélo : distance, durée, étapes de navigation en français, boîte englobante et géométrie encodée (polyline6). Mode de déplacement : `car` (voiture, défaut), `walking` (à pied) ou `cycling` (à vélo). Les valeurs du contrat d'API (`auto`, `pieton`, `velo`) sont acceptées telles quelles. Les consignes suivent le mode — « Conduisez… », « Marchez… », « Pédalez… » — et la réponse renvoie le `mode` utilisé : une durée n'est interprétable qu'accompagnée du mode qui l'a produite. ⚠️ Chaque mode a sa distance maximale : 5 000 km en voiture, 500 km à vélo, 250 km à pied ; au-delà la réponse est un 422 explicite, pas une panne. Pour de simples distances en masse, préfère route_matrix. Plan minimum : Business. Mention OSM ODbL obligatoire.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "destination": {
            "description": "Point d'arrivée : adresse libre OU couple `lat`/`lon`.",
            "properties": {
              "address": {
                "anyOf": [
                  {
                    "minLength": 4,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "Adresse libre (XOR lat/lon)."
              },
              "lat": {
                "anyOf": [
                  {
                    "maximum": 90,
                    "minimum": -90,
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "Latitude WGS84, avec `lon` (XOR address)."
              },
              "lon": {
                "anyOf": [
                  {
                    "maximum": 180,
                    "minimum": -180,
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "Longitude WGS84, avec `lat` (XOR address)."
              }
            },
            "type": "object"
          },
          "mode": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Mode de déplacement : `car` (défaut), `walking` ou `cycling`."
          },
          "origin": {
            "description": "Point de départ : adresse libre OU couple `lat`/`lon`.",
            "properties": {
              "address": {
                "anyOf": [
                  {
                    "minLength": 4,
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "Adresse libre (XOR lat/lon)."
              },
              "lat": {
                "anyOf": [
                  {
                    "maximum": 90,
                    "minimum": -90,
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "Latitude WGS84, avec `lon` (XOR address)."
              },
              "lon": {
                "anyOf": [
                  {
                    "maximum": 180,
                    "minimum": -180,
                    "type": "number"
                  },
                  {
                    "type": "null"
                  }
                ],
                "default": null,
                "description": "Longitude WGS84, avec `lat` (XOR address)."
              }
            },
            "type": "object"
          }
        },
        "required": [
          "origin",
          "destination"
        ],
        "type": "object"
      },
      "name": "compute_route",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "address_id": {
            "description": "Identifiant d'adresse (champ `id`) renvoyé par verify_address ou search_address.",
            "type": "string"
          }
        },
        "required": [
          "address_id"
        ],
        "type": "object"
      },
      "name": "get_address_details",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    },
    {
      "description": "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 relever d'un palier supérieur — son absence ne prouve pas l'inexistence de la donnée. 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ées à des fins de prospection commerciale, `false` = pas d'opposition enregistrée, `null` = non renseigné (à ne pas lire comme `false`). C'est le SEUL endroit où cette information est servie. Plan minimum : Discovery.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "company_id": {
            "description": "SIRET (14 chiffres) de l'établissement, ou SIREN (9 chiffres) pour le siège de l'entreprise.",
            "type": "string"
          }
        },
        "required": [
          "company_id"
        ],
        "type": "object"
      },
      "name": "get_company_details",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    },
    {
      "description": "Calcule une matrice de distances et durées entre N origines et M destinations (jusqu'à 25×25) sur le réseau France (OpenStreetMap), au choix en voiture, à pied ou à vélo. Sans géométrie ni consignes : pour un itinéraire détaillé, utilise compute_route. Mode de déplacement : `car` (voiture, défaut), `walking` (à pied) ou `cycling` (à vélo). Les valeurs du contrat d'API (`auto`, `pieton`, `velo`) sont acceptées telles quelles. ⚠️ La matrice plafonne à 1 500 km en voiture et à 200 km à pied comme à vélo — des limites plus basses que compute_route (5 000 / 250 / 500 km) : un trajet que compute_route accepte peut être refusé ici, en 422. Plan minimum : Growth. Mention OSM ODbL obligatoire.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "destinations": {
            "description": "Points d'arrivée (1 à 25), même forme.",
            "items": {
              "description": "A ``RoutePoint`` is EITHER a free-text ``address`` OR a ``lat``/``lon`` couple\n(mutually exclusive), mirroring trusty-service's ``RouteEndpointInput``.",
              "properties": {
                "address": {
                  "anyOf": [
                    {
                      "minLength": 4,
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "Adresse libre (XOR lat/lon)."
                },
                "lat": {
                  "anyOf": [
                    {
                      "maximum": 90,
                      "minimum": -90,
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "Latitude WGS84, avec `lon` (XOR address)."
                },
                "lon": {
                  "anyOf": [
                    {
                      "maximum": 180,
                      "minimum": -180,
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "Longitude WGS84, avec `lat` (XOR address)."
                }
              },
              "type": "object"
            },
            "type": "array"
          },
          "mode": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Mode de déplacement : `car` (défaut), `walking` ou `cycling`."
          },
          "origins": {
            "description": "Points de départ (1 à 25), chacun une adresse libre OU un couple `lat`/`lon`.",
            "items": {
              "description": "A ``RoutePoint`` is EITHER a free-text ``address`` OR a ``lat``/``lon`` couple\n(mutually exclusive), mirroring trusty-service's ``RouteEndpointInput``.",
              "properties": {
                "address": {
                  "anyOf": [
                    {
                      "minLength": 4,
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "Adresse libre (XOR lat/lon)."
                },
                "lat": {
                  "anyOf": [
                    {
                      "maximum": 90,
                      "minimum": -90,
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "Latitude WGS84, avec `lon` (XOR address)."
                },
                "lon": {
                  "anyOf": [
                    {
                      "maximum": 180,
                      "minimum": -180,
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "Longitude WGS84, avec `lat` (XOR address)."
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "origins",
          "destinations"
        ],
        "type": "object"
      },
      "name": "route_matrix",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "details": {
            "default": true,
            "description": "Inclure les blocs détaillés (position GPS et Lambert 93, IRIS, grille statistique — selon le plan). Défaut vrai.",
            "type": "boolean"
          },
          "limit": {
            "default": 10,
            "description": "Nombre maximal de résultats (défaut 10).",
            "type": "integer"
          },
          "query": {
            "description": "Début d'adresse ou adresse partielle à compléter (numéro, voie, commune…).",
            "type": "string"
          }
        },
        "required": [
          "query"
        ],
        "type": "object"
      },
      "name": "search_address",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    },
    {
      "description": "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). 3 établissements d'un même SIREN ne font donc pas « 3 entreprises trouvées ». 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`. `classement_pertinence` se lit 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, et rien ne s'y complète de mémoire. Une liste vide fait autorité : aucune entreprise ne correspond. La fiche complète s'obtient ensuite via get_company_details. Plan minimum : Discovery — la recherche par proximité (lat/lon/radius_m) nécessite le plan Growth.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "address": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Filtre sur la voie (recherche floue) ; exige `query`."
          },
          "city": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Filtre sur la commune (recherche floue) ; exige `query`."
          },
          "group_by_company": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Vrai : un résultat par entreprise (son meilleur établissement, le siège de préférence) ; faux : un par établissement. Absent : défaut de l'API selon la recherche."
          },
          "lat": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Recherche par proximité (plan Growth) : latitude WGS84 du centre, avec `lon` et `radius_m`."
          },
          "lon": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Longitude WGS84 du centre de la recherche par proximité, avec `lat` et `radius_m`."
          },
          "naf_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Filtre : code NAF/APE de l'activité, ex. `62.02A`."
          },
          "page": {
            "default": 1,
            "description": "Numéro de page, à partir de 1.",
            "type": "integer"
          },
          "per_page": {
            "default": 10,
            "description": "Résultats par page (défaut 10, plafond 25).",
            "type": "integer"
          },
          "postal_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Filtre : code postal exact."
          },
          "query": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Nom, dénomination, sigle ou enseigne ; un SIREN (9 chiffres) ou un SIRET (14 chiffres) donne une correspondance exacte."
          },
          "radius_m": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Rayon en mètres autour du centre (jusqu'à 50 km) ; plan Growth."
          },
          "siren": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Tous les établissements d'une unité légale (SIREN, 9 chiffres)."
          },
          "status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Filtre : `active` (établissement en activité) ou `closed` (fermé)."
          }
        },
        "type": "object"
      },
      "name": "search_company",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "department_code": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Filtre : codes de département (liste, ex. `62`, `2A`). À préférer au nom."
          },
          "department_name": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Filtre : noms de département (liste ; orthographe normalisée automatiquement)."
          },
          "details": {
            "default": true,
            "description": "Inclure les détails de chaque commune (codes, population, coordonnées). Défaut vrai.",
            "type": "boolean"
          },
          "limit": {
            "default": 20,
            "description": "Nombre maximal de résultats (défaut 20).",
            "type": "integer"
          },
          "population_max": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Filtre : population maximale (habitants)."
          },
          "population_min": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Filtre : population minimale (habitants)."
          },
          "postal_code": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Filtre : codes postaux (liste)."
          },
          "query": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Nom de commune, code postal ou code INSEE, complet ou partiel. Optionnel si un filtre est donné."
          },
          "region_code": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Filtre : codes de région (liste)."
          },
          "region_name": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Filtre : noms de région (liste)."
          }
        },
        "type": "object"
      },
      "name": "search_locality",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    },
    {
      "description": "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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "address": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Centre par adresse libre (un nom de commune suffit). Exclusif de `lat`/`lon`."
          },
          "lat": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Latitude WGS84 du centre, avec `lon` et sans `address`."
          },
          "limit": {
            "default": 10,
            "description": "Nombre de résultats par page (défaut 10, plafond 50).",
            "type": "integer"
          },
          "lon": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Longitude WGS84 du centre, avec `lat` et sans `address`."
          },
          "offset": {
            "default": 0,
            "description": "Décalage de pagination : reprendre à `pagination.next_offset` de la réponse précédente.",
            "type": "integer"
          },
          "radius_m": {
            "description": "Rayon de recherche en mètres autour du centre.",
            "type": "integer"
          }
        },
        "required": [
          "radius_m"
        ],
        "type": "object"
      },
      "name": "search_nearby",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    },
    {
      "description": "Vérifie et normalise une adresse française contre le référentiel géographique 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.",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "address": {
            "description": "Adresse postale française en texte libre, telle que saisie (fautes, abréviations et accents manquants tolérés).",
            "type": "string"
          },
          "details": {
            "default": true,
            "description": "Inclure les blocs détaillés (position GPS et Lambert 93, IRIS, grille statistique — selon le plan). Défaut vrai.",
            "type": "boolean"
          },
          "max_results": {
            "default": 5,
            "description": "Nombre maximal de candidats renvoyés (défaut 5).",
            "type": "integer"
          }
        },
        "required": [
          "address"
        ],
        "type": "object"
      },
      "name": "verify_address",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    },
    {
      "description": "Compare de 2 à 10 zones de chalandise en un seul appel et mesure leur cannibalisation. Pour chaque zone, rend exactement ce que `zone_stats` rend (`population`, `menages`, `niveau_de_vie_moyen`, `ages`, `sexe`, `menages_profil`, `logements`, `csp`, `potentiel_depense`, `immobilier`, `activites`, `carreaux`, `source`, `attribution` — voir cet outil pour le sens de chaque bloc), plus `id` et `exclusif` : la population, les ménages et le potentiel que la zone est SEULE à couvrir, calculés comme « la zone moins l'union de toutes les autres » — jamais « total moins les paires », qui à trois zones et plus retrancherait deux fois un triple recouvrement ; `exclusif.part_population` en pour cent de la population de la zone. Entre zones : `chevauchements`, une entrée par paire qui se recouvre (population, ménages et potentiel comptés deux fois ; une paire disjointe n'apparaît pas), et `classement`, tous les identifiants triés sur `rank_by` décroissant : `population` (défaut), `exclusive_population`, `theoretical_potential` ou `exclusive_potential` — ces deux derniers exigent `coefficient`. Chaque élément de `zones` se décrit comme sur `zone_stats` : un centre (`address`, un nom de commune suffit, OU `lat`+`lon` WGS84, jamais les deux) et UNE portée, soit `minutes` (1 à 30) avec `mode` `car` (défaut), `walking` ou `cycling` et, en voiture, `traffic` `free` (défaut) ou `peak` (heure de pointe du matin, vitesses modélisées, pas de trafic temps réel — refusé à pied et à vélo, et pouvant répondre « indisponible » si la plateforme ne l'a pas encore ouvert), soit `radius_km` (1 à 50) à vol d'oiseau ; plus un `id` optionnel (1 à 40 caractères, lettres, chiffres, `_`, `-`, unique dans l'appel) repris dans la réponse, le classement et les erreurs — sans `id`, la position à partir de 1. `reference` : `france` (défaut) ou `department` — UN réglage pour DEUX blocs : l'`indice` de chaque poste CSP et celui de chaque poste d'`activites` sont alors rapportés au département qui pèse le plus dans la zone (`csp.reference.code`, `activites.reference.code`, et leurs libellés respectifs `csp.reference.libelle` / `activites.reference.libelle`, `null` en référence France). `coefficient` (0 exclu à 1) : la part du revenu disponible que le secteur capte, appliquée à toutes les zones, à leurs exclusifs et aux paires ; il déclenche `potentiel_theorique` = revenu disponible estimé × coefficient — une estimation, un potentiel théorique, pas une prévision de chiffre d'affaires ; sans coefficient il vaut `null`, une valeur qui ne s'invente pas. Le guide « Zone de chalandise » donne des repères par fonction de consommation (restauration ≈ 0,048). La CSP est elle aussi une estimation : aucun indice n'est exploitable sur une zone dont `csp.fiabilite.indices_fiables` est faux. Comme sur `zone_stats`, un poste dont la part est inférieure à `csp.fiabilite.part_min` (0,5 %) rend `indice: null` — un refus de servir, pas une donnée manquante ; `effectif` et `part` restent valides — ne jamais reconstituer l'indice à partir de leur rapport avec `reference_part` non plus. `reference_part` donne la part du même poste sur la référence : citer les deux parts côte à côte plutôt qu'un écart — un indice de 82 est un écart de 18 %, pas de 18 points. Le bloc `activites` est rendu pour chaque zone, identique à celui de `zone_stats` : c'est un PLANCHER d'établissements actifs et géolocalisés — ne jamais le présenter comme exhaustif, ni appeler ces établissements des concurrents ; d'une zone à l'autre, comparer les `indice` plutôt que les effectifs, le sous-compte s'y annulant en grande partie. `exclusif` et `chevauchements` ne portent PAS d'établissements : population, ménages et potentiel seulement. Une zone inatteignable (isochrone sans contour) rend des zéros, n'entre dans aucune paire et se classe dernière ; plafond de surface 10 000 km² par zone. Plan minimum : Growth ; un appel compté quel que soit le nombre de zones ; dix isochrones prennent une à deux secondes. `attribution` accompagne tout chiffre cité (INSEE Filosofi et Recensement de la population ; IGN Contours IRIS ; SIRENE (INSEE) pour les établissements du bloc `activites` ; DGFiP DVF pour les prix immobiliers ; OpenStreetMap ODbL dès qu'une zone est une isochrone).",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "coefficient": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Part du revenu disponible que le secteur capte (0 exclu à 1), appliquée à toutes les zones, exclusifs et paires ; requis par les critères de potentiel."
          },
          "rank_by": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Critère du classement : `population` (défaut), `exclusive_population`, `theoretical_potential` ou `exclusive_potential` — ces deux derniers exigent `coefficient`."
          },
          "reference": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Référentiel des indices de chaque zone — UN réglage pour DEUX blocs, `csp` et `activites` : `france` (défaut) ou `department`."
          },
          "zones": {
            "description": "De 2 à 10 zones, chacune avec les arguments de zone_stats (centre + `minutes` ou `radius_km`) et un `id` optionnel.",
            "items": {
              "description": "Une zone de `zone_compare` : les arguments de `zone_stats`, plus un `id`.\n\nVolontairement SANS validateur de portée : le corps REST d'une zone est\nplat, et trusty-service porte déjà la règle « une seule portée » avec ses\ncodes (`portee_ambigue`, `portee_manquante`, `mode_sans_duree`,\n`circulation_sans_duree`, `circulation_mode_incompatible`,\n`identifiant_invalide`), rendus avec l'identifiant de la zone en cause.\nLes recopier ici les ferait vivre à deux endroits. `RoutePoint` valide son\nXOR parce que son corps REST a deux formes ; ce n'est pas le cas ici.\n\nSeuls `lat`/`lon` gardent une borne (`ge`/`le`) : les limites WGS84 sont\nun fait géographique recopié de `RoutePoint`, pas une règle produit ;\n`minutes` et `radius_km` partent hors borne jusqu'au 422 de l'API.",
              "properties": {
                "address": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "Centre par adresse libre — un nom de commune suffit. Exclusif de lat/lon."
                },
                "id": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "Identifiant repris dans la réponse et les erreurs (1 à 40 caractères, lettres, chiffres, `_`, `-`, unique). Sans lui : la position à partir de 1."
                },
                "lat": {
                  "anyOf": [
                    {
                      "maximum": 90,
                      "minimum": -90,
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "Latitude WGS84 du centre, avec `lon` et sans `address`."
                },
                "lon": {
                  "anyOf": [
                    {
                      "maximum": 180,
                      "minimum": -180,
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "Longitude WGS84 du centre, avec `lat` et sans `address`."
                },
                "minutes": {
                  "anyOf": [
                    {
                      "type": "integer"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "Portée isochrone : minutes de trajet depuis le centre (1 à 30). Exclusif de radius_km."
                },
                "mode": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "`car` (défaut), `walking` ou `cycling` — avec `minutes` seulement."
                },
                "radius_km": {
                  "anyOf": [
                    {
                      "type": "number"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "Portée rayon à vol d'oiseau, en km (1 à 50). Exclusif de minutes."
                },
                "traffic": {
                  "anyOf": [
                    {
                      "type": "string"
                    },
                    {
                      "type": "null"
                    }
                  ],
                  "default": null,
                  "description": "`free` (défaut) ou `peak` — avec `minutes` et `mode: car` seulement."
                }
              },
              "type": "object"
            },
            "type": "array"
          }
        },
        "required": [
          "zones"
        ],
        "type": "object"
      },
      "name": "zone_compare",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    },
    {
      "description": "Rend ce que l'INSEE sait de ceux qui habitent une zone de chalandise : `population`, `menages`, `menages_pauvres` (sous le seuil de pauvreté), `niveau_de_vie_moyen` (euros par personne et par an — une moyenne, jamais une médiane), `iris_couverts` (quartiers IRIS touchés), `surface_km2`, et `carreaux` {total, estimes}. Les chiffres sont des sommes des carreaux INSEE Filosofi de 200 m pondérées par la part de chaque carreau dans la zone ; `carreaux.estimes` compte ceux que l'INSEE a imputés au titre du secret statistique — c'est la norme du fichier (souvent la majorité hors des villes denses), pas un défaut de la zone. Depuis la plateforme 1.11, la réponse porte aussi le PROFIL de la zone, en trois blocs de `{effectif, part}` : `ages` (onze tranches INSEE `0_3` … `80_plus` et `inconnu`, parts rapportées à `population`), `menages_profil` (personnes seules, 5 personnes et plus, propriétaires, monoparentaux, en collectif, en maison, parts rapportées à `menages`, plus `surface_moyenne_m2`) et `logements` (`total`, cinq périodes de construction et `sociaux`, parts rapportées à `logements.total`). Les parts sont en pourcentage au dixième, calculées avant arrondi ; les effectifs sont arrondis séparément, leur somme peut différer du total de quelques unités. Depuis la plateforme 1.16, le bloc `sexe` donne `hommes` et `femmes` en `{effectif, part}` plus `population_recensement` — les parts sont rapportées à `population_recensement` (hommes + femmes, la population du recensement répartie sur la zone), pas à `population` : les deux diffèrent de quelques pour cent, c'est normal (ménages ordinaires 2021 contre population totale 2022). C'est une estimation : le sexe n'est diffusé qu'à l'IRIS et réparti sur les carreaux au prorata de leur population ; les limites sont celles de `csp.fiabilite`. Depuis la plateforme 1.12, le bloc `csp` donne les huit catégories socioprofessionnelles des 15 ans et plus (agriculteurs, artisans_commercants, cadres, professions_intermediaires, employes, ouvriers, retraites, autres_inactifs), chacune en `{effectif, part, indice, reference_part}` : l'`indice` vaut 100 × part de la zone / part de la France (100 = la moyenne nationale, 150 = une fois et demie) — ou du département qui pèse le plus dans la zone si `reference` vaut `department` (défaut `france`), son code étant rendu dans `csp.reference.code` et son nom dans `csp.reference.libelle` (`null` en référence France). C'est une estimation, pas une mesure : les CSP ne sont diffusées qu'à l'IRIS et sont réparties sur les carreaux au prorata de leur population — un indice est donc un ordre de grandeur estimé, et il n'y en a aucun d'exploitable quand `csp.fiabilite.indices_fiables` est faux (moins de 1 000 personnes de 15 ans et plus : la zone recopie le profil d'un ou deux IRIS). Un poste dont la part est inférieure à `csp.fiabilite.part_min` (0,5 %) n'a PAS d'indice : `indice` y vaut `null`, et ce n'est pas une donnée manquante — les CSP étant réparties de l'IRIS vers les carreaux, un poste rare porte une erreur relative trop grande pour être rapportée à une référence. Son `effectif` et sa `part` restent servis et se citent normalement ; ne jamais reconstituer l'indice à partir d'eux, ni à partir de leur rapport avec `reference_part` — ce rapport reconstituerait l'indice tout autant, et reste interdit. `reference_part` donne la part du même poste sur la référence : citer les deux parts côte à côte plutôt qu'un écart — un indice de 82 est un écart de 18 %, pas de 18 points. Le bloc `potentiel_depense` donne les unités de consommation reconstituées, le revenu disponible estimé des habitants (`revenu_disponible_estime`, en euros par an) et `revenu_disponible_par_menage` — le chiffre à citer de préférence, en disant « estimation » (niveau de vie écrêté, revenus 2021, unités de consommation reconstituées). `potentiel_theorique` = revenu disponible estimé × `coefficient` n'est calculé que si `coefficient` est passé (0 exclu à 1 : la part du revenu disponible que le secteur capte — le guide « Zone de chalandise » donne des repères par fonction de consommation, restauration ≈ 0,048) ; sinon il vaut `null`, une valeur qui ne s'invente pas. C'est un potentiel théorique, pas une prévision de chiffre d'affaires. Depuis septembre 2026, le bloc `immobilier` donne les PRIX DE VENTE immobiliers de la zone (DVF, DGFiP) : trois séries `maisons`, `appartements` et `locaux_activite`, chacune avec `annees[]` (par année sur cinq ans : `ventes`, `prix_m2_median` en euros par m² de surface réelle bâtie, `reference_prix_m2_median` sur le département), `evolution_pct` (première → dernière année fiable, non annualisée) et `indice` (100 = le département de `reference`, nommé par `libelle`). Ce sont des prix de vente déclarés dans les actes, pas des loyers — ne jamais en déduire un loyer ; les locaux d'activité mêlent boutiques, entrepôts et bureaux, un ordre de grandeur. Sous 20 ventes dans l'année, le prix médian vaut `null` (`fiabilite.annees_fiables` liste les années retenues) ; `hors_couverture` vrai signale une zone hors du jeu DVF (Alsace-Moselle et Mayotte ; les DROM 971-974 sont couverts), pas une zone sans vente. Depuis septembre 2026, le bloc `activites` compte les ÉTABLISSEMENTS de la zone par famille et sous-famille d'activité (boulangeries, tabac, comptabilité…), avec une densité pour 10 000 habitants et un indice contre la FRANCE par défaut — ou contre le département dominant de la zone si `reference` vaut `department`, `activites.reference` disant lequel des deux a servi. C'est un PLANCHER : seuls les établissements actifs et géolocalisés y figurent — `fiabilite.taux_localisation` dit quelle part cela représente. Ne jamais présenter ces comptes comme exhaustifs, ni les appeler des concurrents. `familles[]` porte les 14 familles, toutes, même à zéro ; chacune ses `sous_familles[]`, dont celles à zéro sont omises. Chaque poste donne `cle`, `libelle`, `etablissements`, `part` (de `total`), `densite` (pour 10 000 habitants), `reference_densite` et `indice` (100 = la référence, que `reference.libelle` nomme). L'indice est moins biaisé que l'effectif : calculé de la même façon des deux côtés, le sous-compte s'y annule en grande partie — préférer l'indice pour comparer, l'effectif pour dénombrer. `indice` vaut `null` sous `fiabilite.etablissements_min` (5) établissements dans le poste, sur une zone sans habitant, et quand la référence n'a rien à comparer — soit qu'elle n'ait aucun établissement dans ce poste (`reference_densite` à `0.0` sur une sous-famille, `null` sur une famille), soit qu'aucune population de référence ne soit connue (`reference_densite` à `null`). `densite` est servie dès que la zone a des habitants, et vaut `null` sur une zone qui n'en a aucun (mer, étranger) — ne jamais l'annoncer comme toujours présente ; `etablissements` et `part`, eux, le sont. `fiabilite.indices_fiables` est faux sous 1 000 habitants. Deux limites de la nomenclature NAF à répercuter telles quelles : le tabac est sous-compté (un bar-tabac est codé en débit de boissons et reste donc dans « Cafés, hôtels, restaurants »), et la sous-famille « Rééducation, appareillage et pédicures-podologues » réunit ces trois métiers sans permettre d'en isoler un seul. Le détail des codes NAF de chaque sous-famille est dans le guide « Zone de chalandise », section Activités, avec ses hypothèses et limites. La zone se décrit d'UNE seule façon : soit `minutes` (1 à 30) de trajet depuis le centre, avec `mode` `car` (voiture, défaut), `walking` ou `cycling` ; soit `radius_km` (1 à 50) à vol d'oiseau. Avec `minutes` et `mode` `car`, `traffic` choisit les conditions : `free` (défaut, circulation libre) ou `peak` (heure de pointe du matin, un jour ouvré vers 08:30 — vitesses typiques modélisées par classe de voie et densité, pas de trafic temps réel). `peak` est refusé à pied et à vélo, et peut répondre « indisponible » si la plateforme ne l'a pas encore ouvert. Le centre est SOIT une adresse libre (`address`, un nom de commune suffit), SOIT un couple `lat`+`lon` WGS84 — jamais les deux ; `point_central.precision` dit comment il a été résolu. Plafond de surface : 10 000 km². Une zone sans habitant (mer, étranger) rend des zéros, pas une erreur. Plan minimum : Growth ; un appel compté quelle que soit la portée. `attribution` accompagne tout chiffre cité (INSEE Filosofi, IGN Contours IRIS ; SIRENE (INSEE) pour les établissements du bloc `activites` ; DGFiP DVF pour les prix immobiliers ; OpenStreetMap ODbL quand la portée est une durée).",
      "inputSchema": {
        "additionalProperties": false,
        "properties": {
          "address": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Centre par adresse libre — un nom de commune suffit. Exclusif de `lat`/`lon`."
          },
          "coefficient": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Part du revenu disponible que le secteur capte (0 exclu à 1) ; déclenche `potentiel_theorique`."
          },
          "lat": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Latitude WGS84 du centre, avec `lon` et sans `address`."
          },
          "lon": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Longitude WGS84 du centre, avec `lat` et sans `address`."
          },
          "minutes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Portée isochrone : minutes de trajet depuis le centre (1 à 30). Exclusif de `radius_km`."
          },
          "mode": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Mode de déplacement de l'isochrone : `car` (défaut), `walking` ou `cycling` — avec `minutes` seulement."
          },
          "radius_km": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Portée rayon à vol d'oiseau, en km (1 à 50). Exclusif de `minutes`."
          },
          "reference": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Référentiel des indices — UN réglage pour DEUX blocs, `csp` et `activites` : `france` (défaut) ou `department` (département dominant de la zone)."
          },
          "traffic": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "default": null,
            "description": "Conditions de circulation de l'isochrone : `free` (défaut) ou `peak` (heure de pointe modélisée) — avec `minutes` et `mode: car` seulement."
          }
        },
        "type": "object"
      },
      "name": "zone_stats",
      "outputSchema": {
        "additionalProperties": true,
        "type": "object"
      }
    }
  ]
}

Verify it yourself

curl -s https://api.teppi.xyz/v1/evidence/sha256:9b3fdf7833caf3025690d78c623c3851850b13d499f89fd0fb3a7befd893af06 | sha256sum