> Ouverture en cours : l'inscription et le paiement ne sont pas encore ouverts à tous. L'état du jour : https://subagent.fr/docs/etat.md
>
> Pour un agent : la carte du site est sur https://subagent.fr/llms.txt ; chaque page existe en Markdown, à la même adresse suffixée `.md`.

# `list_suppressions`

> Liste les adresses et domaines bloqués pour cet espace (désinscriptions, plaintes, ajouts manuels), les plus récents d’abord.

## En bref

| Propriété | Valeur |
|---|---|
| Titre | Liste de blocage |
| Outil MCP | `list_suppressions`, sur `https://api.subagent.fr/mcp` |
| Appel HTTP | `POST https://api.subagent.fr/v1/list_suppressions` |
| Accès | permission `read` |
| État de l'espace | vérifié ou non |
| Effet | lecture seule |
| Vue dans l'assistant | oui : voir [Vues](https://subagent.fr/docs/vues.md) |

## Ce que fait l'outil

Le serveur décrit l'outil ainsi à l'agent qui se branche :

> Liste les adresses et domaines bloqués pour cet espace (désinscriptions, plaintes, ajouts manuels), les plus récents d’abord. Avec une adresse complète en query, dit aussi si elle est une adresse morte commune à la plateforme. Pagination par curseur.

## Paramètres

`list_suppressions` accepte ces paramètres. Un paramètre inconnu est refusé avec le code `invalid_argument`.

| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| `query` | texte | non | Une partie d’adresse ou de domaine ; une adresse complète pour savoir si elle est morte. |
| `cursor` | texte | non | Curseur de la page suivante : la valeur `next_cursor` de l’appel précédent. |
| `limit` | entier | non | Nombre d’éléments rendus (20 par défaut). De 1 à 100. |

## Résultat

L'outil rend un texte lisible en français et un objet structuré (`structuredContent`). En HTTP, la réponse est cet objet.

| Champ | Type | Contenu |
|---|---|---|
| `items` | liste | Les entrées de la liste de blocage, les plus récentes d'abord. Chaque élément porte `created_at`, `kind`, `reason`, `scope`, `source`, `value`. |
| `next_cursor` | texte ou `null` | À repasser en cursor pour la page suivante ; `null` à la dernière page. |

## Exemple d'appel

Les valeurs sont fictives.

HTTP :

```sh
curl -X POST https://api.subagent.fr/v1/list_suppressions \
  -H "Authorization: Bearer $SUBAGENT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "query": "exemple.com"
}'
```

MCP (`tools/call`) :

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_suppressions",
    "arguments": {
      "query": "exemple.com"
    }
  }
}
```

## Refus possibles

Aucun refus propre à cet outil. Restent les refus communs à tous les outils (`unauthorized`, `forbidden`, `invalid_argument`, `rate_limited`, `internal`) : voir [Erreurs](https://subagent.fr/docs/erreurs.md#acces).

## Voir aussi

- [Désinscription et blocages : list_suppressions](https://subagent.fr/docs/desinscription.md#list_suppressions)
- [`add_suppression`](https://subagent.fr/docs/reference/add_suppression.md)
- [`remove_suppression`](https://subagent.fr/docs/reference/remove_suppression.md)
- [Tous les outils](https://subagent.fr/docs/reference/index.md)