Skip to main content
Glama
Nexauraholding

Services publics

by Nexauraholding
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

chercher_adresse

Search French addresses by free-text query and get coordinates plus suggested address matches for geocoding, mapping, or location validation.

Instructions

Cherche une adresse avec q et renvoie ses coordonnées et les adresses proposées. Limite : 50 appels/seconde/IP ; ce connecteur se limite à 40 appels/seconde.

Input Schema

NameRequiredDescriptionDefault
qNochaîne décrivant la localisation à rechercher Exemples de requêtes: - /search?q=73 Avenue de Paris Saint-Mandé - /search?q=cimetière Vincennes - /search?q=75056104AE0003 Note: L'absence de valeur est autorisée sur le type parcel pour réaliser une recherche structurée. Par exemple: /search?q=&index=parcel&departmentcode=75&municipalitycode=056&section=AV
latNolatitude d'un localisant pour favoriser les candidats les plus proches.
lonNolongitude d'un localisant pour favoriser les candidats les plus proches.
cityNoFiltre pour les index address et poi. Il permet de filtrer par nom de commune.
typeNoFiltre pour l'index address. Il permet de filtrer par type de données adresse : numéro de maison, rue, commune, ...
indexNoindex(es) de recherche : - <b>address</b> pour la recherche par adresse - <b>parcel</b> pour la recherche par parcelle cadastrale - <b>poi</b> pour la recherche par lieu et unité administrative Il est possible de spécifier plusieurs indexes séparés par une virgule. Exemples: - /search?index=parcel - /search?index=poi,address address
limitNoNombre maximum de résultats retournés. La valeur ne peut pas dépasser 50. Dans le cas où returntruegeometry est activé, la valeur est automatiquement ramenée à 20.
sheetNoFiltre pour l'index parcel. Il permet de filtrer par feuille.
numberNoFiltre pour l'index parcel. Il permet de filtrer par numéro.
depcodeNoFiltre pour les index address et poi. Il permet de filtrer les résultats par code départmeent. Accepte plusieurs valeurs séparées par des virgules (maximum 10).
sectionNoFiltre pour l'index parcel. Il permet de filtrer par section.
categoryNoFiltre pour l'index poi. Il permet de filtrer par catégorie de poi. Les valeurs possibles sont listées dans le getCapabilities du service de géocodage. Accepte plusieurs valeurs séparées par des virgules (maximum 10).
citycodeNoFiltre pour les index address et poi. Il permet de filtrer les résultats par code INSEE. Accepte plusieurs valeurs séparées par des virgules (maximum 200).
postcodeNoFiltre pour les index address et poi. Il permet de filtrer les résultats par code postal. Accepte plusieurs valeurs séparées par des virgules (maximum 50).
autocompleteNoindique si la recherche doit être effectuée en mode auto-complétion (comportement par défaut). 1
districtcodeNoFiltre pour l'index parcel. Il permet de filtrer par code d'arrondissement.
departmentcodeNoFiltre pour l'index parcel. Il permet de filtrer par code de département.
municipalitycodeNoFiltre pour l'index parcel. Il permet de filtrer par code de commune.
returntruegeometryNoindique si la vraie géométrie doit être retournée
oldmunicipalitycodeNoFiltre pour l'index parcel. Il permet de filtrer par code d'ancienne commune.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.1.0

TDQS

B3.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden, and it does contribute valuable operational context: an upstream rate limit of 50 calls/s/IP and a connector-level cap of 40 calls/s. It also names the return payload (coordinates plus candidate addresses). However, it omits error/empty-result behavior, the 50-result cap and its reduction to 20 with returntruegeometry, and the structured parcel search mode — all relevant for a mutation-free but heavily parameterized tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two tight sentences with zero filler: purpose and return first, then the rate-limit caveat. Nothing is buried and every clause carries information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 20-parameter geocoder with no annotations and no output schema, the description covers purpose, return shape, and rate limits, and the schema covers the parameters thoroughly. It still leaves out the result-count ceiling, autocomplete default behavior, and the q-empty structured parcel mode, so it is adequate rather than complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100% across 20 parameters, so the schema already documents index, filters, limit behavior, and confusable pairs like depcode/departmentcode. The description mentions only q, adding no syntax or interaction details beyond the schema — baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (cherche) and resource (adresse), names the primary input q, and says what is returned (coordonnées + adresses proposées). It does not distinguish itself from the sibling adresse_depuis_position, so an agent must infer that this is the text-query path and the sibling is the coordinate path.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no explicit statement of when to use this tool versus adresse_depuis_position, and no prerequisites or exclusions. 'avec q' only weakly implies a text-based lookup; an agent gets no routing guidance beyond that.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools