Skip to main content
Glama
Sign In

Infoparcelle - cadastre, DVF, DPE, PLU

by fr.infoparcelle
OverviewDiscussionsAdmin

infoparcelle_occupants_search

Read-onlyIdempotent

🏪 Rechercher des occupants (établissements/entreprises) sur les parcelles cadastrales.

Fonction: Accéder aux données SIRENE des établissements présents sur les parcelles (commerces, entreprises, services).

Données Occupants: Les données proviennent de la base SIRENE de l'INSEE (Système d'Identification du Répertoire des ENtreprises). Elles incluent:

  • Identification (SIRET, SIREN, NIC, dénomination, enseigne)

  • Activité (code NAF/APE, catégorie, section, division, groupe)

  • État (actif/fermé, siège/établissement secondaire)

  • Effectifs (caractère employeur, tranche d'effectifs)

  • Dates (création, début d'activité, dernier traitement)

  • Localisation (adresse, parcelle, commune, coordonnées)

Filtres de recherche disponibles (20 paramètres):

  1. Identité:

    • siret (14 chiffres - identifiant unique établissement)

    • siren (9 chiffres - identifiant unique entreprise)

    • denomination_complete (recherche par similarité)

    • denomination_usuelle (nom commercial)

  2. Activité:

    • activite_principale (code NAF/APE ex: '10.71C')

    • categorie_activite (libellé de l'activité)

    • naf_section, naf_division, naf_groupe (hiérarchie NAF)

  3. État:

    • etat_administratif (0=Actif, 1=Fermé)

    • etablissement_siege (siège ou établissement secondaire)

    • caractere_employeur (possède des salariés)

    • tranche_effectifs (0, 1, 2, 3, 11, 12, 21, 22, 31, 32, 41, 42, 51, 52, 53)

  4. Dates:

    • date_creation_min/max (création de l'établissement)

    • date_debut_min/max (début d'activité)

  5. Géographiques:

    • code_postal, code_municipalite

    • lat/lon (coordonnées GPS)

    • code_parcelle, code_section

Retourne (35 champs disponibles):

  • Identification: siret, siren, nic, denomination_complete, denomination_usuelle, enseignes (1-3)

  • Activité: activite_principale, activite_principale_registre_metiers, nomenclature_activite_principale

  • Catégorie: categorie_activite, categorie_parent_activite

  • NAF: naf_section, naf_division, naf_groupe, naf_classe, naf_sous_classe

  • État: etat_administratif, caractere_employeur, etablissement_siege, statut_diffusion

  • Effectifs: tranche_effectifs, annee_effectifs

  • Dates: date_creation, date_debut, date_dernier_traitement

  • Adresse: adresse_complete, adresse_numero, adresse_indice_repetition, adresse_nom_voie, adresse_code_postal

  • Localisation: parcelle, municipalite, centre

Tranches d'effectifs:

  • 0 = 0 salarié

  • 1 = 1 ou 2 salariés

  • 2 = 3 à 5 salariés

  • 3 = 6 à 9 salariés

  • 11 = 10 à 19 salariés

  • 12 = 20 à 49 salariés

  • 21 = 50 à 99 salariés

  • 22 = 100 à 199 salariés

  • 31 = 200 à 249 salariés

  • 32 = 250 à 499 salariés

  • 41 = 500 à 999 salariés

  • 42 = 1 000 à 1 999 salariés

  • 51 = 2 000 à 4 999 salariés

  • 52 = 5 000 à 9 999 salariés

  • 53 = 10 000 salariés et plus

Cas d'usage principaux:

  1. Analyse commerciale d'une zone:

    • Identifier tous les commerces dans un quartier

    • Étudier la mixité des activités

    • Repérer les zones commerciales dynamiques

  2. Recherche de concurrents:

    • Trouver les établissements d'un secteur d'activité

    • Analyser la densité des concurrents par zone

    • Identifier les sièges sociaux

  3. Prospection immobilière:

    • Trouver les locaux commerciaux occupés

    • Identifier les grandes entreprises (tranches effectifs)

    • Repérer les opportunités (établissements fermés)

  4. Études économiques:

    • Analyser la structure économique d'une commune

    • Étudier la répartition des secteurs d'activité

    • Suivre l'évolution des créations d'entreprises

Exemples concrets:

  1. Commerces actifs dans le 75008: { code_postal: "75008", etat_administratif: 0 }

  2. Boulangeries à Paris: { code_municipalite: "75056", activite_principale: "10.71C" }

  3. Sièges sociaux d'une entreprise: { siren: "123456789", etablissement_siege: true }

  4. Grandes entreprises (>100 salariés): { code_postal: "69001", tranche_effectifs: "22,31,32,41,42,51,52,53" }

  5. Occupants d'une parcelle: { code_parcelle: "750560000B0064" }

  6. Créations récentes: { code_municipalite: "13055", date_creation_min: "2024-01-01" }

Conseils:

  • Le tri par 'denomination_complete' avec filtre activé utilise la similarité

  • Utilisez etat_administratif=0 pour n'avoir que les établissements actifs

  • Combinez categorie_activite pour recherche par libellé et activite_principale pour code NAF exact

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "infoparcelle_occupants_search"
  }
}

Input Schema

NameRequiredDescriptionDefault
latNoLatitude (WGS84)
lonNoLongitude (WGS84)
sirenNoSIREN (9 chiffres). Accepte plusieurs valeurs
siretNoSIRET (14 chiffres). Accepte plusieurs valeurs
champsNoChamps souhaités. Valeurs possibles: siret, siren, nic, denomination_complete, denomination_usuelle, enseigne_1-3, activite_principale, activite_principale_registre_metiers, nomenclature_activite_principale, categorie_activite, categorie_parent_activite, naf_section, naf_division, naf_groupe, naf_classe, naf_sous_classe, etat_administratif, caractere_employeur, tranche_effectifs, annee_effectifs, date_creation, date_debut, date_dernier_traitement, etablissement_siege, statut_diffusion, adresse_complete, adresse_numero, adresse_indice_repetition, adresse_nom_voie, adresse_code_postal, parcelle, municipalite, centre
formatNoFormatjson
limiteNoRésultats/page
curseurNoCurseur pagination
champ_triNoChamp de tri
geometrieNoGéométrie (centre uniquement)centre
ordre_triNoDirection triasc
naf_groupeNoGroupe NAF
code_postalNoCode postal. Ex: '75008'
naf_sectionNoSection NAF (A-U)
code_sectionNoCode section. Accepte plusieurs valeurs
naf_divisionNoDivision NAF (2 chiffres)
code_parcelleNoCode cadastral. Accepte plusieurs valeurs
date_debut_maxNoDate début activité max (YYYY-MM-DD)
date_debut_minNoDate début activité min (YYYY-MM-DD)
code_municipaliteNoCode INSEE. Ex: '75056'
date_creation_maxNoDate création max (YYYY-MM-DD)
date_creation_minNoDate création min (YYYY-MM-DD)
tranche_effectifsNoTranche effectifs (0-53). Accepte plusieurs valeurs
categorie_activiteNoCatégorie d'activité
etat_administratifNo0=Actif, 1=Fermé
activite_principaleNoCode NAF/APE (ex: '10.71C')
caractere_employeurNoPossède des salariés
etablissement_siegeNoSiège (true) ou secondaire (false)
denomination_usuelleNoNom commercial
denomination_completeNoDénomination complète (similarité)

Output Schema

NameRequiredDescriptionDefault
donneesYes
paginationNoPagination a curseur.

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

A3.9/5.0
Behavior4/5

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

Annotations already declare readOnlyHint/idempotentHint/non-destructive, so the safety profile is covered. The description adds real value beyond that: data provenance (INSEE SIRENE), the field families returned, pagination caps implied by limite (max 50) and curseur, and a note that sorting on denomination_complete switches to similarity matching. It omits rate limits or quota behavior.

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

Conciseness2/5

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

The definition runs to several hundred words and front-loads the wrong material: the exhaustive 20-parameter list and 35-field return list duplicate what the input and output schemas already declare verbatim. The use-case and example sections are genuinely useful, but they are buried after a large block of redundant enumeration, so signal-to-noise is poor.

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

Completeness5/5

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

For a 30-parameter, no-required-field search tool, the description covers data source, every filter family, the enum code mappings, pagination controls, and concrete call examples. With an output schema present and 100% schema coverage, nothing an agent needs in order to call this correctly is missing.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3, but the description adds meaning the schema lacks: the full tranche_effectifs code-to-headcount mapping (schema only says '0-53'), the etat_administratif 0/1 meaning, NAF hierarchy roles, and an example showing multi-value fields are passed as comma-separated strings ('22,31,32...'). The 35-field return list largely restates the champs/output schema, which limits the score.

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?

The opening line gives a specific verb and resource ('Rechercher des occupants (établissements/entreprises) sur les parcelles cadastrales') and immediately narrows the domain to INSEE SIRENE establishments, which distinguishes it from sibling searches like proprietaires_search or coproprietes_search. It does not explicitly name those siblings or explain the boundary with parcelles_search_advanced, so it stops short of a 5.

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

Usage Guidelines4/5

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

A dedicated 'Cas d'usage principaux' section lays out four concrete scenarios (commercial zone analysis, competitor research, real-estate prospecting, economic studies) and six worked filter examples plus tips like using etat_administratif=0 for active-only. That is strong context, but there is no explicit 'do not use this when X, use sibling Y instead' routing guidance.

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

All Infoparcelle - cadastre, DVF, DPE, PLU toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources