​
MCP tools

Ocoya stellt 22 MCP-Tools bereit. MCP-Clients rufen diese Tools über die Standard-JSON-RPC-Methode tools/call auf, aber die meisten Clients erledigen das automatisch, wenn du eine Ocoya-Aktion in natürlicher Sprache anforderst.

Nutze zuerst List-Tools, um Brand-, Profil-, Post-, Brand-, Template- und Workflow-IDs zu ermitteln. Übergebe diese IDs anschließend an Write-Tools.

{
  "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_brandDen autorisierten User identifizieren und Brand-IDs auflösen.
Social profilesocoya_list_social_profiles, ocoya_generate_social_connection_url, ocoya_get_social_profilePublishing-Kanäle auswählen und Flows zum Verbinden von Social Profiles starten.
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_postEntwürfe erstellen, generieren, AI-Kampagnen in die Queue stellen, Inhalte prüfen, aktualisieren, planen, veröffentlichen und entfernen.
Creative contextocoya_list_hashtag_libraries, ocoya_list_studio_templatesHashtag-Bibliotheken und Studio-Templates für generierte Posts finden.
Workflowsocoya_list_workflows, ocoya_get_workflow, ocoya_toggle_workflow, ocoya_run_workflowAutomatisierungen prüfen, aktivieren, deaktivieren und ausführen.
1

Resolve the brand

Rufe ocoya_list_brands auf, optional mit query, und speichere die zurückgegebene id als brandId.

2

Resolve target channels

Für Publishing-Aufgaben rufe ocoya_list_social_profiles mit brandId auf und behalte die Ziel-socialProfileIds.

3

Resolve optional context

Verwende ocoya_list_hashtag_libraries oder ocoya_list_studio_templates, wenn der Post gespeicherte Hashtag- oder visuelle Referenzen nutzen soll.

4

Call the write tool

Erstellen, aktualisieren, planen, veröffentlichen, löschen, umschalten oder ausführen erst, nachdem die IDs und die Nutzerabsicht klar sind.

Verwende ISO-Datetimes für die Planung:

2026-07-01T09:00:00Z

​
Account and brand

ocoya_get_me

Gibt den autorisierten Ocoya-User für die aktuelle MCP-OAuth-Genehmigung zurück.

ocoya_list_brands

Listet Brands auf oder durchsucht sie, die für die aktuelle MCP-Verbindung freigegeben sind.

ocoya_get_brand

Ruft Brand-Details ab, nachdem eine Brand-ID aufgelöst wurde.

​
Social profiles

ocoya_list_social_profiles

Listet verbundene Kanäle für einen freigegebenen Brand auf.

Generate social connection URL

Generiert eine Browser-URL, die einen neuen Flow zum Verbinden eines Social Profiles startet.

ocoya_get_social_profile

Ruft Details für ein verbundenes Social Profile ab.

​
Posts and calendar

ocoya_list_posts

Sucht Post-Gruppen nach Status, Caption und Pagination.

ocoya_list_calendar_posts

Listet geplante Posts innerhalb eines Datumsbereichs auf.

ocoya_get_post

Ruft vollständige Details für eine Post-Gruppe ab.

ocoya_create_post

Erstellt einen Entwurf, plant einen Post oder veröffentlicht sofort.

ocoya_create_ai_post

Generiert einen bearbeitbaren AI-Entwurf mit optionalen Hashtag-, Profil- und Studio-Referenzen.

ocoya_create_ai_campaign

Stellt die Generierung für eine mehrteilige AI-Kampagne in die Queue und gibt sofort mit dem Status GENERATING zurück.

ocoya_update_post

Aktualisiert Caption, Planung, Veröffentlichungsstatus, Medien oder verknüpfte Social Profiles.

ocoya_schedule_post

Plant oder umplant eine bestehende Post-Gruppe.

ocoya_delete_post

Löscht eine Post-Gruppe und storniert zugehörige Planungen.

​
Creative context

ocoya_list_hashtag_libraries

Findet wiederverwendbare Hashtag-Bibliotheken für generierte Entwürfe.

ocoya_list_studio_templates

Findet Studio-Template-IDs, die als visuelle Referenzen genutzt werden können.

​
Workflows

ocoya_list_workflows

Listet Workflow-IDs und aktivierten Status für einen Brand auf.

ocoya_get_workflow

Ruft Workflow-Metadaten und Schritt-Optionen ab.

ocoya_toggle_workflow

Aktiviert oder deaktiviert einen Workflow.

ocoya_run_workflow

Stellt einen sofortigen Workflow-Run mit optionalem Input in die Queue.

​
Write actions

Die folgenden Tools können den Zustand eines Brands verändern:

  • 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

Prüfe die Nutzerabsicht, bevor du sofort veröffentlichst, löschst, Workflows änderst oder Social-Connection-Aktionen ausführst.