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

# Enregistrer les coordonnées d'un prospect

L'outil prospection_coordonnees de Prescriptio dit si un prospect est joignable et enregistre ses coordonnées, sans jamais rendre l'adresse ni le numéro.

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

**MCP (JSON-RPC)**

```json
{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "prospect_id": "<prospect_id>"
    },
    "name": "prospection_coordonnees"
  }
}
```

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

### 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` | `etat` · `poser` | — | etat (défaut) : dit si la fiche est joignable, JAMAIS par quelle adresse ni quel numéro. poser : enregistre une adresse et/ou un téléphone. |
| `email` | texte | — | action poser : l'adresse a enregistrer. Le domaine de la fiche est recalcule avec elle. |
| `prospect_id` | texte | oui | UUID de la FICHE (contact). |
| `source` | texte | — | action poser : d'ou vient la coordonnee (site de la société, signature d'un mail, annuaire...). Ajoutee a la liste des sources de la fiche, sans doublon. |
| `telephone` | texte | — | action poser : le numéro a enregistrer, tel qu'il se compose. |

## Quand l'utiliser

C'est le troisieme temps du travail de prospection, juste avant d'écrire. ⚠ Ne renvoie JAMAIS l'adresse ni le numéro — seulement des booleens (adresse connue ou simple repere, rebond, desabonnement, téléphone present) et le DOMAINE de la société. Les coordonnées d'un prospect ne sortent du produit que par l'ecran de reveal, jamais par un outil. action "etat" (défaut) lit ; action "poser" enregistre un email et/ou un téléphone trouves ailleurs, avec leur source. Une fiche issue d'un import porte souvent un repere "@unknown.invalid" : écrire a cette adresse, c'est écrire a personne. Requiert un compte connecte.

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

```text
Ce prospect est-il joignable, et par quel canal ?
```

Outil : `prospection_coordonnees` · Portée : `mcp:write`, écrit dans votre espace · Coût : 1 appel, aucune unité de dossier · Limite : agit dans votre espace seulement, jamais dans la donnée publique

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

## Les pages qui s'en servent

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

- [Préparer un e-mail de prospection individuel, sourcé](https://prescriptio.fr/docs/guides/e-mail-de-prospection-individuel) : Guides, Prospecter
- [Organiser la prospection](https://prescriptio.fr/skills/prescriptio-gerer-prospection) : IA, Les skills du plugin

## Voir aussi

- [prospection_objectif](https://prescriptio.fr/docs/api/prospection_objectif) : L'objectif de prospection de l'utilisateur, et ou il en est
- [prospection_cibles](https://prescriptio.fr/docs/api/prospection_cibles) : Le rang de cible d'un prospect : décideur (celui qui décide), prioritaire (a travailler maintenant) ou…
- [prospection_pipeline](https://prescriptio.fr/docs/api/prospection_pipeline) : Le pipeline commercial de l'organisation : ses étapes et leurs effectifs
- [prospection_historique](https://prescriptio.fr/docs/api/prospection_historique) : L'historique d'un prospect : tout ce qui s'est passe avec une personne, sur tous les canaux, dans un seul fil
- [prospection_profils_cibles](https://prescriptio.fr/docs/api/prospection_profils_cibles) : Lire ou définir les profils de cibles propres à votre espace
- [Catalogue des outils](https://prescriptio.fr/docs/api) : Tous les outils, rangés par module
