# events.subscribe

Créer un abonnement de polling à une alerte active. Premier démarrage : événements futurs seulement. Conserver une clé stable par automatisation.

POST `/api/mcp/v1/events.subscribe` · contrat 1.0.0 · OAuth `mcp:write` · offre payante : true.

Outil MCP : `prescriptio_evenements_abonner` ; même handler métier.

## Entrée

```json
{
  "additionalProperties": false,
  "properties": {
    "alerte_id": {
      "type": "string"
    },
    "key": {
      "maxLength": 120,
      "minLength": 1,
      "type": "string"
    }
  },
  "required": [
    "alerte_id",
    "key"
  ],
  "type": "object"
}
```

## Exemple synthétique

```json
{
  "alerte_id": "00000000-0000-0000-0000-000000000001",
  "key": "scenario-isolation"
}
```

## Sortie

```json
{
  "properties": {
    "checkpoint": {
      "type": "string"
    },
    "created": {
      "type": "boolean"
    },
    "first_run": {
      "type": "string"
    },
    "id": {
      "type": "string"
    },
    "subscription_id": {
      "type": "string"
    }
  },
  "required": [
    "id",
    "subscription_id",
    "created",
    "checkpoint"
  ],
  "type": "object"
}
```

[Authentification, quotas, pagination et erreurs](/docs/reference/concepts.md). Les propriétés additionnelles des résultats historiques restent autorisées ; ce schéma n'invente pas les champs manquants.
