MCP / Alerts
Alerts
4 outils MCP pour créer et gérer des alertes webhook sur les nouvelles transactions DVF.
0 créditPro / EnterpriseMCP · REST
Plan Pro ou Enterprise requis
Ces outils retournent une erreur si utilisés avec un plan Free ou Agent. Maximum 20 alertes actives par clé API. Passez à un abonnement depuis la page Tarifs.
alert_create
Crée une alerte webhook. Dès qu'une transaction DVF correspondante est importée, un POST est envoyé à votre URL.
Paramètres
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
| webhook_url* | string | — | URL HTTPS recevant les notifications (POST JSON). |
| code_postal | string | — | Code postal cible. Au moins un filtre de localisation requis. |
| commune | string | — | Commune en majuscules (ex. PARIS 11, LYON). |
| code_departement | string | — | Code département (ex. 75, 69). |
| type_local | enum | — | Maison | Appartement | Terrain | Local commercial | Dépendance | Local industriel. |
| prix_min / prix_max | number | — | Filtre sur le prix de vente en euros. |
| surface_min / surface_max | number | — | Filtre sur la surface en m². |
Exemple de prompt
Crée une alerte pour être notifié des ventes d'appartements entre 400 000 et 700 000 € avec au moins 40m² dans le 75011. Envoie les notifications sur https://mon-app.com/webhooks/dvf.
Réponse
{
"alert": {
"id": "alert_x9y8z7",
"webhook_url": "https://mon-app.com/webhooks/dvf",
"code_postal": "75011",
"type_local": "Appartement",
"prix_min": 400000,
"prix_max": 700000,
"surface_min": 40,
"is_active": true,
"created_at": "2026-03-20T14:00:00.000Z"
}
}alert_list
Liste toutes les alertes (actives et inactives). 0 crédit.
Exemple de prompt
Liste toutes mes alertes DVF actives.
alert_update
Met à jour une alerte existante. Utilisez is_active: false pour suspendre sans supprimer. 0 crédit.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
| id* | string | — | Identifiant de l'alerte. |
| is_active | boolean | — | false pour suspendre temporairement. |
| webhook_url / code_postal / commune / code_departement / type_local / prix_min / prix_max / surface_min / surface_max | varies | — | Tous optionnels, même interface que alert_create. |
Exemple de prompt
Mets à jour l'alerte alert_x9y8z7 : prix maximum à 750 000 € et désactive-la temporairement.
alert_delete
Supprime définitivement une alerte. 0 crédit.
| Paramètre | Type | Défaut | Description |
|---|---|---|---|
| id* | string | — | Identifiant de l'alerte à supprimer. |
Exemple de prompt
Supprime l'alerte alert_x9y8z7.
Format du payload webhook
Normi envoie ce JSON à votre webhook_url lors de chaque nouvelle transaction correspondante :
{
"event": "new_transaction",
"alert_id": "alert_x9y8z7",
"transaction": {
"id": "dvf_abc123",
"address": "12 RUE DE LA ROQUETTE, 75011, PARIS 11",
"date_mutation": "2026-03-18",
"type_local": "Appartement",
"surface_carrez": 58.5,
"valeur_fonciere": 545000,
"prix_m2": 9316
}
}Bonnes pratiques
- Votre endpoint doit répondre en moins de 10 secondes avec un statut 2xx.
- DVF est mis à jour semestriellement (avril / octobre) — les alertes se déclenchent à chaque import.
- La limite de 20 alertes actives ne compte que les alertes avec
is_active: true. - Voir aussi REST /v1/alerts pour la gestion depuis un backend.