Lire une sélection de la carte | Documentation Prescriptio

Lecture seule, ouvert à tous les comptes, offre gratuite comprise. Chaque appel compte pour une unité de quota.

généré depuis le schéma

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "contexte_id": "<contexte_id>"
    },
    "name": "carto_selection_lire"
  }
}

curl -sS https://prescriptio.fr/api/mcp \
  -H 'Authorization: Bearer <jeton>' \
  -H 'Content-Type: application/json' \
  -d '{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"contexte_id":"<contexte_id>"},"name":"carto_selection_lire"}}'

Réponsegénérée depuis le schéma

{
  "action": "<texte>",
  "download_url": "<texte>",
  "fields": {},
  "files": [
    {}
  ],
  "ok": false,
  "page": 0,
  "pages_total": 0,
  "quota": {},
  "texte": "<texte>"
}

Paramètres

collectionpoints · parcelles · proprietaires

Collection à paginer. Par défaut points, ou parcelles pour Terrain. Les totaux concernent la capture, qui peut être plafonnée.

contexte_idtexterequis

cursortexte

next_cursor reçu ; conserver contexte_id, revision et collection entre les pages. (max. Caractères 200)

limitentier

(min 1, max 100, défaut 50)

revisionentier

Version capturée reçue dans la demande. À conserver pour lire exactement cette sélection, même si la carte a changé depuis. (min 1)

Quand l'utiliser

Couche, zone INSEE, filtres, statistiques, objets et limites de couverture. Fournir contexte_id reçu dans la demande. Les points peuvent être plafonnés : utiliser les statistiques calculées par le serveur, jamais une moyenne des seuls points retournés. Citer les identifiants des objets. Conserver revision pour déposer une analyse avec carto_analyse_enregistrer. Une absence de donnée ne prouve pas l'absence de risque, de projet ou de qualification.

Texte du registre des outils, rendu lisible ; la vue agent le garde tel quel.

Le prompt qui le déclenche

Voir le prompt

Collez ce prompt dans votre agent IA, une fois Prescriptio connecté. Remplacez ce qui est entre crochets.

Lis la sélection cartographique que je viens de te confier depuis Prescriptio et résume ce qu'elle contient.

Outil : carto_selection_lire · Portée : mcp:read, lecture seule · Coût : 1 appel, aucune unité de dossier · Limite : 100 résultats par page au plus

En bref

Effets: lecture seule
Portée OAuth: mcp:read
Conditions d’accès: Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas.
Données lues: l'espace du compte authentifié (ses alertes, ses dossiers, sa base)
Distribution: MCP historique
En REST: aucune opération : il s'appelle par le connecteur MCP

Réponse

Le résultat arrive dans content[0].text (le JSON sérialisé) et dans structuredContent (le même objet). L'exemple donne les types, jamais des valeurs réelles. Un champ absent ou null n'est ni un zéro ni une estimation : la source ne l'a pas renseigné.

Erreurs et quotas

Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (marches_dce, mairies_deliberations et leurs téléchargements) qui est décomptée.

Les compteurs d’appels et de dossiers sont communs. Chaque action peut aussi être soumise à des droits et plafonds métier : Codes d'erreur et Authentification et quotas.

Les skills qui s'en servent

prescriptio-analyser-territoiresLe skill du plugin qui route cet outil

Les pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite carto_selection_lire.

Les diagnostics de performance énergétique (DPE)Documentation, Les données CartographiesDocumentation, Les modules Les propriétaires fonciers (personnes morales)Documentation, Les données Les risques naturels et technologiquesDocumentation, Les données Analyser un territoireIA, Les skills du plugin

Voir aussi

carto_permis_rechercherPermis de construire, d'aménager et de démolir (base officielle Sitadel, historique national)carto_transactionsVentes immobilières officielles (DVF) : ~8 millions de mutations depuis 2018, dédupliquées par vente (1…carto_chantiers_rechercherObjets de chantier (chantier / grue / engin) annotés à l'œil sur une image datée, croisés avec un permis…carto_analyse_enregistrerDéposer une analyse privée dans la vue Cartos de votre organisation Catalogue des outilsTous les outils, rangés par module

[Index de la documentation](https://prescriptio.fr/docs/llms.txt) # Lire une sélection de la carte L'outil carto_selection_lire de Prescriptio lit exactement la sélection cartographique que vous avez confiée à votre agent depuis Prescriptio : couche, zone, filtres, statistiques, objets et limites de couverture. ### Squelette d'appel, généré depuis le schéma **MCP (JSON-RPC)** ```json { "id": 1, "jsonrpc": "2.0", "method": "tools/call", "params": { "arguments": { "contexte_id": "<contexte_id>" }, "name": "carto_selection_lire" } } ``` **HTTP (curl)** ```bash curl -sS https://prescriptio.fr/api/mcp \ -H 'Authorization: Bearer <jeton>' \ -H 'Content-Type: application/json' \ -d '{"id":1,"jsonrpc":"2.0","method":"tools/call","params":{"arguments":{"contexte_id":"<contexte_id>"},"name":"carto_selection_lire"}}' ``` ### Forme de la réponse, générée depuis le schéma ```json { "action": "<texte>", "download_url": "<texte>", "fields": {}, "files": [ {} ], "ok": false, "page": 0, "pages_total": 0, "quota": {}, "texte": "<texte>" } ``` ## Paramètres | Nom | Type | Requis | Description | |---|---|---|---| | `collection` | `points` · `parcelles` · `proprietaires` | — | Collection à paginer. Par défaut points, ou parcelles pour Terrain. Les totaux concernent la capture, qui peut être plafonnée. | | `contexte_id` | texte | oui | — | | `cursor` | texte | — | next_cursor reçu ; conserver contexte_id, revision et collection entre les pages. (max. caractères 200) | | `limit` | entier | — | (min 1, max 100, défaut `50`) | | `revision` | entier | — | Version capturée reçue dans la demande. À conserver pour lire exactement cette sélection, même si la carte a changé depuis. (min 1) | ## Quand l'utiliser couche, zone INSEE, filtres, statistiques, objets et limites de couverture. Fournir contexte_id reçu dans la demande. Les points peuvent être plafonnés : utiliser les statistiques calculées par le serveur, jamais une moyenne des seuls points retournés. Citer les identifiants des objets. Conserver revision pour déposer une analyse avec carto_analyse_enregistrer. Une absence de donnée ne prouve pas l'absence de risque, de projet ou de qualification. **Prompt prêt à coller : Le prompt qui le déclenche** ```text Lis la sélection cartographique que je viens de te confier depuis Prescriptio et résume ce qu'elle contient. ``` Outil : `carto_selection_lire` · Portée : `mcp:read`, lecture seule · Coût : 1 appel, aucune unité de dossier · Limite : 100 résultats par page au plus ## En bref | | | |---|---| | Effets | lecture seule | | Portée OAuth | `mcp:read` | | Conditions d’accès | Chaque action conserve ses droits, ses conditions d’offre et ses quotas ; sa présence dans le catalogue ne les lève pas. | | Données lues | l'espace du compte authentifié (ses alertes, ses dossiers, sa base) | | Distribution | MCP historique | | En REST | aucune opération : il s'appelle par le connecteur MCP | ## Réponse Le résultat arrive dans `content[0].text` (le JSON sérialisé) et dans `structuredContent` (le même objet). L'exemple donne les **types**, jamais des valeurs réelles. Un champ absent ou `null` n'est ni un zéro ni une estimation : la source ne l'a pas renseigné. ## Erreurs et quotas Cet outil ne consomme aucune unité de dossier : chercher est gratuit, c'est la lecture d'un dossier (`marches_dce`, `mairies_deliberations` et leurs téléchargements) qui est décomptée. Les compteurs d’appels et de dossiers sont communs. Chaque action peut aussi être soumise à des droits et plafonds métier : [Codes d'erreur](https://prescriptio.fr/docs/reference/erreurs) et [Authentification et quotas](https://prescriptio.fr/docs/reference/authentification#les-quotas). ## Les skills qui s'en servent - [prescriptio-analyser-territoires](https://prescriptio.fr/skills/prescriptio-analyser-territoires) : Le skill du plugin qui route cet outil ## Les pages qui s'en servent Calculé depuis la documentation : chaque page qui cite `carto_selection_lire`. - [Les diagnostics de performance énergétique (DPE)](https://prescriptio.fr/docs/donnees/dpe) : Documentation, Les données - [Cartographies](https://prescriptio.fr/docs/cartographies) : Documentation, Les modules - [Les propriétaires fonciers (personnes morales)](https://prescriptio.fr/docs/donnees/proprietaires-fonciers) : Documentation, Les données - [Les risques naturels et technologiques](https://prescriptio.fr/docs/donnees/risques) : Documentation, Les données - [Analyser un territoire](https://prescriptio.fr/skills/prescriptio-analyser-territoires) : IA, Les skills du plugin ## Voir aussi - [carto_permis_rechercher](https://prescriptio.fr/docs/api/carto_permis_rechercher) : Permis de construire, d'aménager et de démolir (base officielle Sitadel, historique national) - [carto_transactions](https://prescriptio.fr/docs/api/carto_transactions) : Ventes immobilières officielles (DVF) : ~8 millions de mutations depuis 2018, dédupliquées par vente (1… - [carto_chantiers_rechercher](https://prescriptio.fr/docs/api/carto_chantiers_rechercher) : Objets de chantier (chantier / grue / engin) annotés à l'œil sur une image datée, croisés avec un permis… - [carto_analyse_enregistrer](https://prescriptio.fr/docs/api/carto_analyse_enregistrer) : Déposer une analyse privée dans la vue Cartos de votre organisation - [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module