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 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 :

• Profile — l’outil accepte un argument profileKey pour cibler un sous-profil.
• Account — l’outil ne prend pas de profileKey ; il opère au niveau du compte.

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 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.

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.