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

# Travailler votre base de données

L'outil base de Prescriptio travaille la base de données de votre organisation : chercher une fiche, en créer une, la qualifier, la noter, la ranger dans une liste ou un segment, ou la pousser dans le pipeline.

### 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": "chercher"
    },
    "name": "base"
  }
}
```

**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":"chercher"},"name":"base"}}'
```

### 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` | `chercher` · `creer` · `statut` · `tag` · `note` · `contact` · `archiver` · `restaurer` · `listes` · `liste_creer` · `liste_ajouter` · `liste_retirer` · `segment` · `segment_couper` · `pipeline` | oui | — |
| `criteres` | objet | — | segment : q, dept (2 ou 3 caracteres), naf, ville, rge (bool), statut, tag. |
| `criteres.dept` | texte | — | — |
| `criteres.naf` | texte | — | — |
| `criteres.q` | texte | — | — |
| `criteres.rge` | booléen | — | — |
| `criteres.statut` | texte | — | — |
| `criteres.tag` | texte | — | — |
| `criteres.ville` | texte | — | — |
| `fiche_id` | texte | — | — |
| `fiche_ids` | liste de texte | — | (max. éléments 500) |
| `fonction` | texte | — | (max. caractères 120) |
| `limit` | entier | — | (min 1, max 100) |
| `liste_id` | texte | — | — |
| `nom` | texte | — | (max. caractères 200) |
| `prenom` | texte | — | (max. caractères 80) |
| `q` | texte | — | chercher : mot du nom ou de la ville (sans accent). (max. caractères 120) |
| `retirer` | booléen | — | — |
| `siren` | texte | — | — |
| `siret` | texte | — | — |
| `statut` | texte | — | chercher : filtre ; statut : la valeur a poser (entreprise : prospect \ (max. caractères 40) |
| `tag` | texte | — | (max. caractères 60) |
| `texte` | texte | — | (max. caractères 4000) |
| `type` | `entreprise` · `contact` · `acheteur` · `projet` | — | chercher / creer : le type de fiche. |
| `ville` | texte | — | (max. caractères 120) |

## Quand l'utiliser

action:"chercher" { type, q?, statut?, limit? } liste les fiches ; "creer" { type, siren|siret } crée une fiche liee au referentiel, ou { type, nom, ville } une fiche saisie hors referentiel ; "statut" { fiche_id, statut } ; "tag" { fiche_id, tag, retirer? } ; "note" { fiche_id, texte } ; "contact" { fiche_id (entreprise), prenom, nom, fonction? } rattache une personne ; "archiver" / "restaurer" { fiche_id } ; "listes" ; "liste_creer" { nom, fiche_ids? } ; "liste_ajouter" / "liste_retirer" { liste_id, fiche_ids } ; "segment" { nom, criteres:{q?,dept?,naf?,ville?,rge?} } enregistre un segment vivant depuis des filtres ; "segment_couper" { liste_id } ; "pipeline" { fiche_ids | liste_id } pousse des contacts (avec e-mail) dans le pipeline commercial. Les identifiants viennent de chercher / base_suivis.

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

```text
Cherche dans ma base Prescriptio les architectes que je suis à Lyon.
```

Outil : `base` · 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`.

- [Base de données](https://prescriptio.fr/docs/base-de-donnees) : Documentation, Les modules
- [Lister les cabinets et les entreprises d'un métier sur votre territoire](https://prescriptio.fr/docs/guides/cabinets-et-entreprises-d-un-territoire) : Guides, Bureau d'études
- [Organiser la base de travail](https://prescriptio.fr/skills/prescriptio-gerer-base) : IA, Les skills du plugin

## Voir aussi

- [base_suivis](https://prescriptio.fr/docs/api/base_suivis) : La base de données du client : ce qu'elle contient, et la couche de travail posee dessus
- [base_revue](https://prescriptio.fr/docs/api/base_revue) : La Revue de la base du client : les points en attente et deux gestes
- [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module