# Outils MCP

> La liste des outils du MCP Fransys, ce que fait chacun, et lesquels ne font que lire.

Source : https://docs.fransys.cloud/reference/outils-mcp/ Vérifié sur la console le 2026-10-23.

## Lecture

Ces outils ne changent rien.

| Outil | Ce qu'il fait |
|---|---|
| `list_projects` | Les projets de l'organisation : id, nom, statut et clusters. |
| `get_project` | Un projet et ses services : réglages (secrets masqués), variables, domaines, liaisons, changements en attente et erreurs de validation. |
| `list_clusters` | Les clusters : hébergeur, région, état, nombre de machines, configuration et coût mensuel estimé. |
| `get_cluster` | Un cluster : configuration, état, projets hébergés et coût mensuel estimé. |
| `get_service_logs` | Les dernières lignes du journal d'un service. |
| `get_service_health` | Les contrôles de santé d'un service : statut, message, dernier et prochain contrôle. |
| `query_metrics` | Une requête PromQL instantanée sur un cluster. |
| `list_plans` | Les plans de l'organisation, avec leur statut et leur avancement. |
| `get_plan` | Un plan complet : tâches, avancement, décision. |
| `get_plan_format` | Le format des plans : règles, catalogue des actions, exemples. À lire avant `prepare_plan`. |
| `draft_service_copy` | Rédige les tâches qui copient un service (réglages, variables, liaisons), à mettre dans un plan. Ne crée rien. |

## Plans

Ces outils déposent ou changent un plan, jamais votre infrastructure : une personne valide chaque plan dans la console.

| Outil | Ce qu'il fait |
|---|---|
| `prepare_plan` | Dépose un plan « À décider ». Rien n'est exécuté. |
| `update_plan` | Modifie un plan préparé par l'agent, tant qu'il n'est pas validé. |
| `cancel_plan` | Annule un plan préparé par l'agent, tant qu'il n'est pas validé. |
| `revert_plan` | Propose un nouveau plan qui défait un plan exécuté. |

## Estimation

| Outil | Ce qu'il fait |
|---|---|
| `get_estimation_guide` | Comment traduire un besoin en description de projet : questions à poser, criticité, taille des services. |
| `list_server_types` | Les machines d'une région et leur prix mensuel. |
| `estimate_project` | Le coût mensuel hors taxes d'un projet, avec le catalogue du jour. |

## Aucun outil pour exécuter

Le MCP n'a aucun outil pour valider ou exécuter un plan. Voir [Ce qu'un agent peut faire](https://docs.fransys.cloud/agents/ce-qu-un-agent-peut-faire/).
