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

# Gérer vos alertes

L'outil evenements_alertes de Prescriptio liste, crée et supprime vos alertes de recherche, sur onze sources surveillables ; une alerte ne se modifie pas, elle se supprime puis se recrée.

> **Attention :** Créer l’alerte n’envoie pas d’e-mail pendant l’appel. Cela ne garantit pas son exclusion des récapitulatifs ultérieurs : le traitement relit les préférences de notification du compte et du type d’événement. L’absence de contrôle du canal de l’alerte sur ce chemin est déduite du code local, non vérifiée par un essai d’envoi. Vérifiez **Paramètres › Notifications** ; ce réglage concerne le compte, pas seulement cette alerte.

### Exemple d'appel, synthétique

**MCP (JSON-RPC)**

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "action": "list"
    },
    "name": "evenements_alertes"
  }
}
```

**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":{"action":"list"},"name":"evenements_alertes"}}'
```

### 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 |
|---|---|---|---|
| `action` | `list` · `add` · `remove` | oui | list (mes alertes), add (creer), remove (supprimer). |
| `departement` | texte | — | Code département (01-95, 2A, 2B, 971-978). Filtre aussi les attributions sur leur département renseigné ; un contrat sans département reste hors d’une alerte départementale. Sur la source dce, restreint aux dossiers rapprochés d’un marché. |
| `departements` | liste de texte | — | Plusieurs codes département (mêmes regles que département) : une région = la liste de ses départements. |
| `frequency` | `realtime` · `daily` · `weekly` | — | Espacement MINIMAL du rejeu (défaut daily). Le robot passe toutes les 3 heures : realtime = a chaque passage, daily = au plus une fois par jour, weekly = une fois par semaine. |
| `id` | texte | — | UUID de l'alerte (requis pour remove ; via action:list). |
| `montant_min` | nombre | — | Montant minimum en euros. S'applique a la source attribution UNIQUEMENT (DECP, montant renseigne). Sans effet sur marché, dce et permis : le montant estimé n'est publié que sur 0,12 % des avis ouverts, le filtre y viderait l'alerte. (min 0) |
| `name` | texte | — | Nom de l'alerte (requis pour add). Reutiliser un nom existant avec d'AUTRES criteres est une erreur : supprimer puis recreer. (max. caractères 120) |
| `query` | texte | — | Mots-cles rejoues (requis pour add, 2 caracteres minimum). Une liste separee par des virgules vaut un OU. (max. caractères 500) |
| `sources` | liste de `marche` · `dce` · `attribution` · `permis` · `reseaux_sociaux` · `mairie` · `bodacc` · `entreprise` · `contact` · `dvf` · `site` | — | Sources surveillables, défaut = toutes. marché = nouveaux avis publiés, plus un rappel quand la remise approche (J-7) ; dce = nouveaux dossiers de consultation citant vos termes ; attribution = marchés attribués (DECP) citant vos termes, dans les départements suivis ; permis = permis autorisés des 45 derniers jours (Sitadel, publié par dumps) ; reseaux_sociaux = nouveaux posts observés sur les réseaux sociaux citant vos termes ; mairie = nouveaux PV de conseils municipaux citant vos termes ; bodacc = nouvelles annonces légales (BODACC) citant vos termes ; entreprise = nouvelles entreprises de l'annuaire citant vos termes ; contact = nouveaux contacts de l'annuaire citant vos termes ; dvf = ventes immobilières récentes des départements suivis (le terme n'y est pas appliqué) ; site = nouvelles pages de sites d'entreprises citant vos termes. Aucune autre source n'est surveillable : une valeur hors de cette liste est REFUSEE. |

## Quand l'utiliser

Une alerte rejoue périodiquement une recherche sur les sources surveillables énumérées dans sources. Les limites de texte, géographie et fraîcheur diffèrent selon la source ; elles figurent dans le schéma et les warnings. realtime signifie chaque passage du robot, pas une ingestion instantanée. action:"add" -> name et query requis (+ sources, département, montant_min, frequency). action:"remove" -> id (via action:"list"). Pas de modification : remove puis add.

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

```text
Crée une alerte Prescriptio sur les dossiers de consultation qui citent « laine de bois ».
```

Outil : `evenements_alertes` · 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 | `POST /api/mcp/v1/alertes.list` : [alertes.list](https://prescriptio.fr/docs/api/alertes.list) |

## 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-gerer-veille](https://prescriptio.fr/skills/prescriptio-gerer-veille) : Le skill du plugin qui route cet outil

## Les pages qui s'en servent

Calculé depuis la documentation : chaque page qui cite `evenements_alertes`.

- [Alertes](https://prescriptio.fr/docs/alertes) : Documentation, Les modules
- [Être alerté quand un appel d'offres ou un dossier cite votre matériau](https://prescriptio.fr/docs/guides/etre-alerte-sur-son-materiau) : Guides, Prescripteur de matériaux
- [Faire la veille du jour des marchés publics du bâti](https://prescriptio.fr/docs/guides/veille-du-jour) : Guides, Entreprise de travaux
- [Playbooks](https://prescriptio.fr/agents-ia/playbooks) : IA, Aller plus loin
- [Prompts du prescripteur de matériaux](https://prescriptio.fr/docs/prompts/prescripteur-materiaux) : IA, Prompts par métier
- [Événements et relève](https://prescriptio.fr/docs/integrations/evenements) : IA, Intégrations
- [Prompts de l'entreprise de travaux](https://prescriptio.fr/docs/prompts/entreprise-travaux) : IA, Prompts par métier
- [Organiser une veille](https://prescriptio.fr/skills/prescriptio-gerer-veille) : IA, Les skills du plugin
- [Événements d'alerte](https://prescriptio.fr/docs/reference/evenements) : Référence, Pour commencer
- [Comment être alerté des nouveaux appels d'offres sur mon matériau ?](https://prescriptio.fr/docs/connaissances/alerte-appels-offres-materiau) : Base de connaissances, Repérer les affaires

## Voir aussi

- [alertes.list](https://prescriptio.fr/docs/api/alertes.list) : La même action, en opération REST
- [evenements_abonnement_creer](https://prescriptio.fr/docs/api/evenements_abonnement_creer) : Abonner une automatisation aux futures notifications d'une alerte active
- [evenements_lire](https://prescriptio.fr/docs/api/evenements_lire) : Lire les événements d'un abonnement autorisé, au plus 100 par page
- [evenements_abonnement_revoquer](https://prescriptio.fr/docs/api/evenements_abonnement_revoquer) : Révoquer un abonnement d'automatisation ; les lectures suivantes sont refusées
- [evenements_acquitter](https://prescriptio.fr/docs/api/evenements_acquitter) : Acquitter un événement après traitement réussi par l'automatisation
- [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module