> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chataigne.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Outils et ressources MCP

> Référence des 24 outils MCP orientés restaurant et des six ressources Chataigne.

La surface MCP restaurant contient 18 outils de lecture et 6 actions opérationnelles. Les inputs refusent les propriétés inconnues, les listes sont limitées à 50 éléments, les transcriptions à 100 messages et les analytics à huit métriques sur 366 jours maximum. Les capacités supplémentaires d’administration de plateforme sont documentées uniquement dans l’espace Admin protégé.

## Contexte et espaces de travail

| Outil                                    | Usage                                                              | Input principal             |
| ---------------------------------------- | ------------------------------------------------------------------ | --------------------------- |
| `chataigne_context_get`                  | Inspecter utilisateur délégué, client OAuth, scopes et déploiement | Aucun input                 |
| `chataigne_workspaces_list`              | Découvrir organisations et établissements accessibles              | `cursor?`, `limit?`         |
| `chataigne_business_organization_get`    | Lire un groupe et ses établissements                               | `business_organization_id`  |
| `chataigne_location_get`                 | Lire le résumé opérationnel sûr d’un restaurant                    | `location_id`               |
| `chataigne_location_settings_get`        | Lire uniquement les sections de paramètres choisies                | `location_id`, `sections[]` |
| `chataigne_location_ordering_status_get` | Lire le statut Ouvert, Fermé, Rush ou Pause                        | `location_id`               |

Les sections de paramètres sont `store`, `order`, `opening_hours`, `delivery`, `payment_methods`, `ai`, `loyalty`, `referrals`, `notifications` et `privacy`.

## Catalogue

| Outil                        | Usage                                                             | Input principal                                 |
| ---------------------------- | ----------------------------------------------------------------- | ----------------------------------------------- |
| `chataigne_catalogs_list`    | Lister des résumés compacts de catalogues                         | `location_id`                                   |
| `chataigne_catalog_search`   | Rechercher sans charger tout l’arbre du menu                      | `location_id`, `query?`, `kinds?`, `available?` |
| `chataigne_catalog_item_get` | Lire un produit, une option, liste d’options, catégorie ou bundle | `kind`, `item_id`                               |

Les résultats de recherche incluent une URI `chataigne://catalog-items/...` lorsqu’elle est disponible.

## Commandes et clients

| Outil                      | Usage                                                    | Input principal                            |
| -------------------------- | -------------------------------------------------------- | ------------------------------------------ |
| `chataigne_orders_list`    | Rechercher par propriétaire, statut, service et date     | `owner`, filtres, curseur                  |
| `chataigne_order_get`      | Lire lignes, totaux, fulfillment et historique de statut | `order_id`, `include_customer_contact?`    |
| `chataigne_customers_list` | Rechercher des profils scoped sans coordonnées           | `owner`, filtres, curseur                  |
| `chataigne_customer_get`   | Lire un client dans son périmètre propriétaire           | `owner`, `customer_id`, `include_contact?` |

Le propriétaire est toujours explicite :

```json theme={null}
{ "type": "location", "id": "loc_..." }
```

ou :

```json theme={null}
{ "type": "business_organization", "id": "org_..." }
```

Les coordonnées d’une commande exigent à la fois `orders.read` et `customers.read`.

## Conversations

| Outil                          | Usage                                           | Input principal                     |
| ------------------------------ | ----------------------------------------------- | ----------------------------------- |
| `chataigne_conversations_list` | Rechercher des résumés et états chatbot/rapport | `owner`, filtres, curseur           |
| `chataigne_conversation_get`   | Lire une transcription merchant-safe bornée     | `conversation_id`, `message_limit?` |

Les traces d’outils internes, identités provider brutes et payloads provider ne sont jamais renvoyés.

## Analytics et configuration

| Outil                         | Usage                                         | Input principal                    |
| ----------------------------- | --------------------------------------------- | ---------------------------------- |
| `chataigne_analytics_query`   | Calculer jusqu’à huit métriques en un appel   | `owner`, `metrics[]`, `from`, `to` |
| `chataigne_discounts_list`    | Lister les remises du propriétaire            | `owner`                            |
| `chataigne_integrations_list` | Lister providers et indicateurs non sensibles | `location_id`, `categories?`       |

Métriques analytics disponibles :

```text theme={null}
total_orders, gross_volume, average_cart, orders_evolution,
orders_by_channel, average_cart_by_channel, orders_heatmap,
cancelled_orders, active_customers, new_customers,
repeat_customer_rate, interactions, conversion_rate,
top_products, trending_products, delivery_cities,
discount_usage, products_sold, products_per_order
```

## Actions opérationnelles

Ces actions restaurant sont visibles uniquement si le déploiement des écritures est actif et si le token possède le scope d’écriture.

| Outil                                     | Effet et précondition de sûreté                                         |
| ----------------------------------------- | ----------------------------------------------------------------------- |
| `chataigne_location_ordering_status_set`  | Définit Online, Rush ou Pause ; exige `expected_mode`                   |
| `chataigne_catalog_item_availability_set` | Bascule atomiquement produit/option ; exige `expected_available`        |
| `chataigne_order_status_set`              | Avance vers un statut non destructif autorisé ; exige `expected_status` |
| `chataigne_conversation_chatbot_set`      | Active/désactive atomiquement l’IA ; exige `expected_active`            |
| `chataigne_conversation_message_send`     | Envoie un message texte manuel ; exige `idempotency_key`                |
| `chataigne_conversation_instruction_send` | Envoie une instruction à l’IA ; exige `idempotency_key`                 |

`chataigne_order_status_set` accepte uniquement `accepted`, `in_preparation`, `awaiting_shipment`, `awaiting_collection`, `in_delivery` ou `completed`. Il ne peut ni annuler, ni rejeter, ni marquer un échec de livraison, ni rembourser.

## Templates de ressources

Le serveur annonce uniquement les templates couverts par les scopes du token :

```text theme={null}
chataigne://business-organizations/{id}
chataigne://locations/{id}
chataigne://catalog-items/{kind}/{id}
chataigne://orders/{id}
chataigne://customers/{ownerType}/{ownerId}/{id}
chataigne://conversations/{id}
```

Les ressources renvoient `application/json` et appliquent la même autorisation en temps réel que l’outil de détail correspondant.