​
MCP tools

Ocoya expose 22 outils MCP. Les clients MCP appellent ces outils via la méthode JSON-RPC standard tools/call, mais la plupart des clients gèrent cela automatiquement lorsque vous demandez une action Ocoya en langage naturel.

Utilisez d’abord les outils de liste pour obtenir les IDs de brand, profile, post, brand, template et workflow. Ensuite, transmettez ces IDs aux outils d’écriture.

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ocoya_list_brands",
    "arguments": {}
  }
}

​
Tool categories

CategoryToolsTypical use
Account and brandocoya_get_me, ocoya_list_brands, ocoya_get_brandIdentifier l’utilisateur autorisé et obtenir les IDs de brand.
Social profilesocoya_list_social_profiles, ocoya_generate_social_connection_url, ocoya_get_social_profileChoisir les canaux de publication et lancer les parcours de connexion de social profiles.
Posts and calendarocoya_list_posts, ocoya_list_calendar_posts, ocoya_get_post, ocoya_update_post, ocoya_create_post, ocoya_create_ai_post, ocoya_create_ai_campaign, ocoya_schedule_post, ocoya_delete_postRédiger, générer, mettre en file d’attente des campagnes IA, inspecter, mettre à jour, planifier, publier et supprimer du contenu.
Creative contextocoya_list_hashtag_libraries, ocoya_list_studio_templatesTrouver des bibliothèques de hashtags et des templates Studio pour les posts générés.
Workflowsocoya_list_workflows, ocoya_get_workflow, ocoya_toggle_workflow, ocoya_run_workflowInspecter, activer, désactiver et exécuter des automatisations.
1

Resolve the brand

Appelez ocoya_list_brands, éventuellement avec query, et conservez l’id renvoyé comme brandId.

2

Resolve target channels

Pour les tâches de publication, appelez ocoya_list_social_profiles avec brandId et conservez les socialProfileIds cibles.

3

Resolve optional context

Utilisez ocoya_list_hashtag_libraries ou ocoya_list_studio_templates lorsque le post doit utiliser des hashtags enregistrés ou des références visuelles.

4

Call the write tool

Créez, mettez à jour, planifiez, publiez, supprimez, activez ou exécutez uniquement lorsque les IDs et l’intention de l’utilisateur sont clairs.

Utilisez des datetimes ISO pour la planification :

2026-07-01T09:00:00Z

​
Account and brand

ocoya_get_me

Renvoie l’utilisateur Ocoya autorisé pour l’agrément OAuth MCP actuel.

ocoya_list_brands

Liste ou recherche les brands approuvées pour la connexion MCP actuelle.

ocoya_get_brand

Récupère les détails d’une brand après résolution de son ID.

​
Social profiles

ocoya_list_social_profiles

Liste les canaux connectés pour une brand approuvée.

Generate social connection URL

Génère une URL de navigateur qui lance un nouveau parcours de connexion de social profile.

ocoya_get_social_profile

Récupère les détails d’un social profile connecté.

​
Posts and calendar

ocoya_list_posts

Recherche des groupes de posts par statut, légende et pagination.

ocoya_list_calendar_posts

Liste les posts planifiés dans une plage de dates.

ocoya_get_post

Récupère tous les détails d’un groupe de posts.

ocoya_create_post

Crée un brouillon, planifie un post ou publie immédiatement.

ocoya_create_ai_post

Génère un brouillon IA prêt à être modifié avec, en option, des références de hashtags, de profiles et de Studio.

ocoya_create_ai_campaign

Met en file d’attente la génération d’une campagne IA multi-posts et renvoie immédiatement avec le statut GENERATING.

ocoya_update_post

Met à jour la légende, la planification, l’état de publication, les médias ou les social profiles associés.

ocoya_schedule_post

Planifie ou replanifie un groupe de posts existant.

ocoya_delete_post

Supprime un groupe de posts et annule les planifications associées.

​
Creative context

ocoya_list_hashtag_libraries

Trouve des bibliothèques de hashtags réutilisables pour les brouillons générés.

ocoya_list_studio_templates

Trouve des IDs de templates Studio à utiliser comme références visuelles.

​
Workflows

ocoya_list_workflows

Liste les IDs de workflows et leur état d’activation pour une brand.

ocoya_get_workflow

Récupère les métadonnées du workflow et les options de ses étapes.

ocoya_toggle_workflow

Active ou désactive un workflow.

ocoya_run_workflow

Met en file d’attente une exécution immédiate de workflow avec une entrée optionnelle.

​
Write actions

Les outils ci-dessous peuvent modifier l’état d’une brand :

  • ocoya_create_post
  • ocoya_create_ai_post
  • ocoya_update_post
  • ocoya_schedule_post
  • ocoya_delete_post
  • Generate social connection URL
  • ocoya_toggle_workflow
  • ocoya_run_workflow

Vérifiez l’intention de l’utilisateur avant toute publication immédiate, suppression, modification de workflow ou action de connexion sociale.