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

# Suivre les fiches de votre base

L'outil base_suivis de Prescriptio dit ce que contient la base de votre organisation (entreprises, acheteurs publics, projets) et y ajoute, retire ou qualifie un suivi.

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

**MCP (JSON-RPC)**

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

**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","type":"entreprise"},"name":"base_suivis"}}'
```

### 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 |
|---|---|---|---|
| `acheteur_id` | texte | — | UUID de l'acheteur public (type=acheteur). |
| `action` | `list` · `add` · `remove` · `qualifier` · `etiqueter` · `noter` | oui | list/add/remove gerent la PRESENCE dans la base ; qualifier/etiqueter/noter posent la couche de travail sur une fiche qui y est déjà. |
| `cle` | texte | — | Pour un projet, clé unique de l’intention : rejouer la même clé évite de doubler une note. (min. caractères 8, max. caractères 160) |
| `entreprise_id` | texte | — | UUID entreprise (CORE). |
| `limit` | entier | — | (min 1, max 100) |
| `nom` | texte | — | action=add, type=entreprise, SANS siren/siret : crée une fiche HORS REFERENTIEL pour un acteur absent de l'annuaire. Elle ne se mettra pas a jour toute seule — a n'utiliser que si la recherche par nom n'a rien rendu. |
| `note` | texte | — | action=noter : le texte, visible par toute l'équipe. |
| `page` | entier | — | (min 1) |
| `projet_id` | texte | — | UUID du projet detecte (type=projet). Il se lit dans un action:"list" type:"projet" ou sur l'ecran Projets ; projets_rechercher permet aussi de le rechercher. |
| `retirer` | booléen | — | action=etiqueter : true retire l'etiquette au lieu de la poser. |
| `scope` | `me` · `team` | — | Portee du list : me (défaut) ou team. SANS EFFET — une fiche appartient a l'organisation, la réponse le dit (scope_applique). |
| `siren` | texte | — | SIREN 9 chiffres (type=entreprise). |
| `siret` | texte | — | SIRET 14 chiffres (type=entreprise ou acheteur). |
| `statut` | `prospect` · `client` · `a_qualifier` · `concurrent` · `null` | — | action=qualifier, type=entreprise. `null` RETIRE la qualification (geste réel, pas une absence). |
| `tag` | texte | — | action=etiqueter : le libelle de l'etiquette. La casse et les accents sont ignores (« Maconnerie » = « MAÇONNERIE »). |
| `type` | `entreprise` · `acheteur` · `projet` | oui | Type d'entité suivie. Les CONTACTS ne s'ecrivent pas ici (opt-out et coordonnées encadres) : les lire avec annuaire_contacts. |
| `ville` | texte | — | Ville de la fiche hors referentiel (avec `nom`). |

## Quand l'utiliser

TROIS TYPES : entreprise (ecran Concurrence), acheteur public (ecran Acheteurs), projet detecte (ecran Projets). PRESENCE — action list / add / remove. Identifiant selon le type : entreprise -> siren OU siret OU entreprise_id ; acheteur -> siret OU acheteur_id ; projet -> projet_id. Une entreprise absente de l'annuaire s'ajoute par `nom` (+ `ville`), en fiche hors referentiel. COUCHE DE TRAVAIL, sur une fiche déjà dans la base — action qualifier (statut prospect/client/a_qualifier/concurrent, ou null pour l'effacer ; entreprises seulement), etiqueter (`tag`, + `retirer:true` pour l'oter), noter (`note`, visible par l'équipe). Le `list` rend aussi le statut, les etiquettes et les fiches HORS referentiel — ne jamais conclure « pas dans votre base » sans l'avoir appele. Trouver un identifiant : annuaire_entreprises. Pour les recherches sauvegardees : evenements_alertes. Les contacts et les communes ne s'ecrivent pas ici : annuaire_contacts et mairies_deliberations.

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

```text
Que contient ma base Prescriptio, et quelles entreprises suis-je en ce moment ?
```

Outil : `base_suivis` · Portée : `mcp:write`, écrit dans votre espace · Coût : 1 appel, aucune unité de dossier · Limite : 100 résultats par page au plus

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

## Les pages qui s'en servent

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

- [Votre organisation et votre équipe](https://prescriptio.fr/docs/organisation) : Documentation, Compte et organisation
- [Base de données](https://prescriptio.fr/docs/base-de-donnees) : Documentation, Les modules
- [Savoir qui remporte les marchés de votre lot dans votre département](https://prescriptio.fr/docs/guides/qui-remporte-les-marches-de-votre-lot) : Guides, Entreprise de travaux
- [Playbooks](https://prescriptio.fr/agents-ia/playbooks) : IA, Aller plus loin
- [Organiser la base de travail](https://prescriptio.fr/skills/prescriptio-gerer-base) : IA, Les skills du plugin

## Voir aussi

- [base_revue](https://prescriptio.fr/docs/api/base_revue) : La Revue de la base du client : les points en attente et deux gestes
- [base](https://prescriptio.fr/docs/api/base) : Travailler la base de données du client (module Base de données)
- [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module