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

# Chercher des contacts publics

L'outil annuaire_contacts de Prescriptio trouve les contacts publics du bâti (décideurs, référents) d'une entreprise par son SIREN, ou par nom et fonction dans une zone, sans jamais renvoyer leurs coordonnées.

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

**MCP (JSON-RPC)**

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "annuaire_contacts"
  }
}
```

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

### Forme de la réponse, générée depuis le schéma

```json
{
  "_meta": {},
  "next_cursor": "<texte>",
  "results": [
    {
      "fields": {},
      "id": "<texte>",
      "resume": "<texte>",
      "titre": "<texte>"
    }
  ],
  "total_estimated": 0
}
```

## Paramètres

| Nom | Type | Requis | Description |
|---|---|---|---|
| `cursor` | texte | — | Curseur next_cursor de la page précédente, repassé tel quel. |
| `limit` | entier | — | (min 1, max 50, défaut `20`) |
| `localisation` | objet | — | Zone géographique (mode query), UNE granularité ; filtre le département de l'entreprise rattachee. National = omettre. |
| `localisation.commune` | texte | — | Nom de commune, code postal ou code INSEE (ramene au département). |
| `localisation.dept` | texte | — | Code département : 01-95, 2A/2B ou 971-976. |
| `localisation.region` | texte | — | Nom de région — couvre tous ses départements en un appel. |
| `query` | texte | — | Nom, fonction ou mots-cles pour rechercher un contact (décideur, prescripteur). UNE requête = UN sujet. |
| `siren` | texte | — | SIREN 9 chiffres : les contacts publics rattaches a cette entreprise (fonction, entité). (format `^\d{9}$`) |

## Quand l'utiliser

Avec siren (9 chiffres) : les contacts rattaches a une entreprise. Avec query (+ localisation) : rechercher des contacts par nom, fonction ou mots-cles dans une zone. Chaque résultat donne l'identité, la fonction et l'entité rattachee (entreprise ou acheteur public). Les coordonnées (téléphone, e-mail) ne sont jamais renvoyees ici : elles se revelent a l'unite cote application.

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

```text
Avec Prescriptio, trouve les fonctions de décision publiées pour les bureaux d'études thermiques de Gironde.
```

Outil : `annuaire_contacts` · Portée : `mcp:read`, lecture seule · Coût : 1 appel, aucune unité de dossier · Limite : 50 résultats par page au plus

## En bref

| | |
|---|---|
| Effets | lecture seule |
| Portée OAuth | `mcp:read` |
| 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 | la donnée publique du bâti — aucune coordonnée personnelle n'est jamais renvoyée |
| 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-identifier-entreprises](https://prescriptio.fr/skills/prescriptio-identifier-entreprises) : Le skill du plugin qui route cet outil

## Les pages qui s'en servent

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

- [Les contacts publics](https://prescriptio.fr/docs/donnees/contacts) : Documentation, Les données
- [Annuaire](https://prescriptio.fr/docs/annuaire) : Documentation, Les modules
- [Identifier des entreprises et leurs interlocuteurs](https://prescriptio.fr/skills/prescriptio-identifier-entreprises) : IA, Les skills du plugin

## Voir aussi

- [annuaire_entreprises](https://prescriptio.fr/docs/api/annuaire_entreprises) : Annuaire des entreprises du bâti (SIRENE + RNE/INPI, ~5,6 M fiches)
- [annuaire_dirigeants](https://prescriptio.fr/docs/api/annuaire_dirigeants) : Dirigeants et représentants légaux du bâti (RNE/INPI)
- [annuaire_annonces_legales](https://prescriptio.fr/docs/api/annuaire_annonces_legales) : Annonces légales des entreprises (BODACC, ~358 000 publications)
- [annuaire_organigramme](https://prescriptio.fr/docs/api/annuaire_organigramme) : Organigramme d’une entreprise du bâti, en ordre décisionnel
- [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module