​
MCP tools

Ocoya espone 22 strumenti MCP. I client MCP chiamano questi strumenti tramite il metodo JSON-RPC standard tools/call, ma la maggior parte dei client gestisce tutto in automatico quando chiedi un’azione di Ocoya in linguaggio naturale.

Usa prima gli strumenti di elenco per recuperare gli ID di brand, profilo, post, brand, template e workflow. Poi passa questi ID agli strumenti di scrittura.

{
  "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_brandIdentifica l’utente autorizzato e recupera gli ID dei brand.
Social profilesocoya_list_social_profiles, ocoya_generate_social_connection_url, ocoya_get_social_profileScegli i canali di pubblicazione e avvia i flussi di connessione dei social profile.
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_postCrea bozze, genera, mette in coda campagne AI, ispeziona, aggiorna, programma, pubblica e rimuovi contenuti.
Creative contextocoya_list_hashtag_libraries, ocoya_list_studio_templatesTrova hashtag libraries e Studio templates per i post generati.
Workflowsocoya_list_workflows, ocoya_get_workflow, ocoya_toggle_workflow, ocoya_run_workflowIspeziona, attiva, disattiva ed esegui automazioni.
1

Resolve the brand

Chiama ocoya_list_brands, opzionalmente con query, e conserva l’id restituito come brandId.

2

Resolve target channels

Per i task di pubblicazione, chiama ocoya_list_social_profiles con brandId e conserva i socialProfileIds di destinazione.

3

Resolve optional context

Usa ocoya_list_hashtag_libraries o ocoya_list_studio_templates quando il post deve usare hashtag salvati o riferimenti visivi.

4

Call the write tool

Crea, aggiorna, programma, pubblica, elimina, attiva o esegui solo dopo che gli ID e l’intento dell’utente sono chiari.

Usa datetime ISO per la programmazione:

2026-07-01T09:00:00Z

​
Account and brand

ocoya_get_me

Restituisce l’utente Ocoya autorizzato per la concessione OAuth MCP corrente.

ocoya_list_brands

Elenca o cerca i brand approvati per la connessione MCP corrente.

ocoya_get_brand

Recupera i dettagli di un brand dopo aver risolto un ID brand.

​
Social profiles

ocoya_list_social_profiles

Elenca i canali collegati per un brand approvato.

Generate social connection URL

Genera un URL per il browser che avvia un nuovo flusso di connessione di un social profile.

ocoya_get_social_profile

Recupera i dettagli di un singolo social profile collegato.

​
Posts and calendar

ocoya_list_posts

Cerca gruppi di post per stato, caption e paginazione.

ocoya_list_calendar_posts

Elenca i post programmati all’interno di un intervallo di date.

ocoya_get_post

Recupera tutti i dettagli di un gruppo di post.

ocoya_create_post

Crea una bozza, programma un post o pubblica immediatamente.

ocoya_create_ai_post

Genera una bozza AI pronta da modificare con hashtag, profili e riferimenti Studio opzionali.

ocoya_create_ai_campaign

Mette in coda la generazione di una campagna AI multi-post e restituisce subito con stato GENERATING.

ocoya_update_post

Aggiorna caption, programmazione, stato di pubblicazione, media o social profile collegati.

ocoya_schedule_post

Programma o riprogramma un gruppo di post esistente.

ocoya_delete_post

Elimina un gruppo di post e annulla le programmazioni correlate.

​
Creative context

ocoya_list_hashtag_libraries

Trova hashtag libraries riutilizzabili per le bozze generate.

ocoya_list_studio_templates

Trova gli ID degli Studio templates da usare come riferimenti visivi.

​
Workflows

ocoya_list_workflows

Elenca gli ID dei workflow e lo stato di abilitazione per un brand.

ocoya_get_workflow

Recupera i metadati del workflow e le opzioni degli step.

ocoya_toggle_workflow

Abilita o disabilita un workflow.

ocoya_run_workflow

Mette in coda un’esecuzione immediata del workflow con input opzionale.

​
Write actions

Gli strumenti qui sotto possono modificare lo stato di un 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

Controlla l’intento dell’utente prima di pubblicazioni immediate, eliminazioni, modifiche ai workflow o azioni di connessione dei social.