[Index de la documentation](https://prescriptio.fr/docs/llms.txt)

# Enregistrer une analyse de la carte

L'outil carto_analyse_enregistrer de Prescriptio dépose une analyse privée, rédigée par votre agent IA, dans la vue Cartos de votre organisation, à partir de la sélection qu'il a lue.

### Squelette d'appel, généré depuis le schéma

**MCP (JSON-RPC)**

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "analyse": {
        "limites": [
          "<limites>"
        ],
        "observations": [
          {
            "ids": [
              "<ids>"
            ],
            "texte": "<texte>"
          }
        ],
        "resume": "<resume>",
        "selection_ids": [
          "<selection_ids>"
        ],
        "titre": "<titre>"
      },
      "cle": "<cle>",
      "contexte_id": "<contexte_id>",
      "revision": 0
    },
    "name": "carto_analyse_enregistrer"
  }
}
```

**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":{"analyse":{"limites":["<limites>"],"observations":[{"ids":["<ids>"],"texte":"<texte>"}],"resume":"<resume>","selection_ids":["<selection_ids>"],"titre":"<titre>"},"cle":"<cle>","contexte_id":"<contexte_id>","revision":0},"name":"carto_analyse_enregistrer"}}'
```

### 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 |
|---|---|---|---|
| `analyse` | objet | oui | — |
| `analyse.limites` | liste de texte | — | (max. éléments 30) |
| `analyse.observations` | liste de objet | — | (max. éléments 100) |
| `analyse.resume` | texte | oui | (min. caractères 1, max. caractères 8000) |
| `analyse.selection_ids` | liste de texte | — | (max. éléments 50) |
| `analyse.titre` | texte | — | (max. caractères 200) |
| `cle` | texte | oui | (min. caractères 8, max. caractères 160) |
| `contexte_id` | texte | oui | — |
| `revision` | entier | oui | (min 1) |

## Quand l'utiliser

Lire d'abord carto_selection_lire et reprendre sa revision. Fournir une clé unique par intention : rejouer la même demande ne doit pas doubler l'analyse. Le résumé et les observations distinguent faits, interprétations et données manquantes; ids et selection_ids reprennent uniquement les identifiants lus ; selection_ids contient au plus 50 objets prioritaires. Le dépôt propose une sélection, il ne déplace pas la carte de l'utilisateur. Ne déposer que l'analyse demandée par l'utilisateur.

**Prompt prêt à coller : Le prompt qui le déclenche**

```text
Écris ton analyse de cette zone et dépose-la dans la vue Cartos de mon organisation.
```

Outil : `carto_analyse_enregistrer` · Portée : `mcp:write`, écrit dans votre espace · Coût : 1 appel, aucune unité de dossier · Limite : agit dans votre espace seulement, jamais dans la donnée publique

## En bref

| | |
|---|---|
| Effets | lecture et écriture dans l'espace du compte |
| Portée OAuth | `mcp:write` |
| 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_analyse_enregistrer`.

- [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
- [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_selection_lire](https://prescriptio.fr/docs/api/carto_selection_lire) : Lire exactement la sélection cartographique confiée depuis Prescriptio
- [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module