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

# Catalogue des outils MCP

> Les 27 outils exposés par le MCP Server Ayrshare — publications, historique, statistiques, commentaires, messages directs, profils, médias, génération, webhooks et erreurs — regroupés par domaine avec leur portée et leur objectif.

Le [MCP Server](/additional/mcp-action-server) Ayrshare expose **27 outils**, regroupés ci-dessous par domaine. Chaque outil est distribué en interne via la véritable chaîne d'API Ayrshare.

## Portée

Chaque outil est de portée **Profile** ou **Account** :

<ul class="custom-bullets">
  <li>**Profile** — l'outil accepte un argument `profileKey` pour cibler un sous-profil.</li>
  <li>**Account** — l'outil ne prend **pas** de `profileKey` ; il opère au niveau du compte.</li>
</ul>

Les six outils qui ne prennent **aucun** argument `profileKey` sont : `create_profile`, `list_profiles`, `explain_error`, `validate_media`, `generate_post` et `recommend_hashtags`. Tous les autres outils acceptent un `profileKey` ; `generate_jwt_social_linking_url` en **requiert** un. Remarque : `recommend_hashtags` ne prend aucun argument `profileKey`, mais lit tout de même l'en-tête `Profile-Key` de la connexion pour choisir le compte TikTok associé sur lequel s'appuyer, de sorte que ses résultats sont spécifiques au profil.

Lorsque à la fois un argument `profileKey` par appel et un en-tête `Profile-Key` sont présents, l'argument l'emporte. Consultez [Connect & Setup](/additional/mcp-action-connect#precedence-argument-wins-over-header) pour les règles de priorité.

## Publications

| Outil           | Portée  | Objectif                                                             |
| --------------- | ------- | -------------------------------------------------------------------- |
| `create_post`   | Profile | Publier sur une ou plusieurs plateformes associées.                  |
| `validate_post` | Profile | Validation à blanc, avec la même entrée que `create_post`.           |
| `get_post`      | Profile | Récupérer une publication par Ayrshare Post ID.                      |
| `update_post`   | Profile | Mettre à jour une publication planifiée ou en attente d'approbation. |
| `retry_post`    | Profile | Renvoyer une publication qui a échoué.                               |

## Historique

| Outil                  | Portée  | Objectif                                                                                                                                                                                                                                                                       |
| ---------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `get_post_history`     | Profile | Publications envoyées via Ayrshare.                                                                                                                                                                                                                                            |
| `get_platform_history` | Profile | Publications et statistiques directement depuis le réseau, y compris les publications non-Ayrshare. Pour une recherche X/Twitter par `userId`/`userName`, utilisez uniquement l'API Key du compte ; un argument `profileKey` ou un en-tête `Profile-Key` renvoie l'erreur 400. |

## Statistiques

| Outil                             | Portée  | Objectif                                                                                                                                                                                                                                                                |
| --------------------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `get_post_analytics`              | Profile | Métriques par publication, par Ayrshare Post ID.                                                                                                                                                                                                                        |
| `get_post_analytics_by_social_id` | Profile | Métriques par publication, par Social Post ID natif.                                                                                                                                                                                                                    |
| `get_social_network_analytics`    | Profile | Statistiques et données démographiques à l'échelle du compte pour un compte social connecté. Pour une recherche X/Twitter par `userId`/`userName`, utilisez uniquement l'API Key du compte ; un argument `profileKey` ou un en-tête `Profile-Key` renvoie l'erreur 400. |

## Commentaires

| Outil           | Portée  | Objectif                                   |
| --------------- | ------- | ------------------------------------------ |
| `get_comments`  | Profile | Lire les commentaires sur une publication. |
| `add_comment`   | Profile | Commentaire de premier niveau.             |
| `reply_comment` | Profile | Répondre à un commentaire.                 |

## Messages / DM

| Outil               | Portée  | Objectif                                           |
| ------------------- | ------- | -------------------------------------------------- |
| `get_messages`      | Profile | Récupérer les DM pour une plateforme.              |
| `send_message`      | Profile | Envoyer un DM.                                     |
| `get_auto_response` | Profile | Lire les paramètres de réponse automatique aux DM. |
| `set_auto_response` | Profile | Configurer la réponse automatique aux DM.          |

## Profils

| Outil                             | Portée  | Objectif                                                            |
| --------------------------------- | ------- | ------------------------------------------------------------------- |
| `list_profiles`                   | Account | Lister les sous-profils.                                            |
| `create_profile`                  | Account | Créer un sous-profil.                                               |
| `generate_jwt_social_linking_url` | Profile | Générer une URL d'association sociale JWT (nécessite `profileKey`). |

## Médias

| Outil            | Portée  | Objectif                                                                      |
| ---------------- | ------- | ----------------------------------------------------------------------------- |
| `validate_media` | Account | Vérifier via HEAD qu'une URL de média est accessible ; renvoie `contentType`. |

## Génération

| Outil                | Portée  | Objectif                                                                                                                                                                                      |
| -------------------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `generate_post`      | Account | Rédiger un brouillon de publication par IA.                                                                                                                                                   |
| `recommend_hashtags` | Account | Suggestions de hashtags à partir des données de nombre de vues TikTok. Utilise le compte TikTok associé au profil défini par l'en-tête `Profile-Key` ; ne prend aucun `profileKey` par appel. |

## Webhooks

| Outil                | Portée  | Objectif                         |
| -------------------- | ------- | -------------------------------- |
| `register_webhook`   | Profile | Enregistrer un webhook.          |
| `unregister_webhook` | Profile | Désenregistrer un webhook.       |
| `list_webhooks`      | Profile | Lister les webhooks enregistrés. |

## Erreurs

| Outil           | Portée  | Objectif                                                                 |
| --------------- | ------- | ------------------------------------------------------------------------ |
| `explain_error` | Account | Décoder un code d'erreur Ayrshare en cause, classification et correctif. |

<Info>
  Ce catalogue est vérifié par rapport au `tools/list` du serveur en direct. D'autres outils sont prévus (par exemple des outils Links). En cas de doute, interrogez `tools/list` pour obtenir l'ensemble faisant autorité. Le catalogue est maintenu par l'équipe MCP Server.
</Info>