​
MCP tools

A Ocoya expõe 22 ferramentas MCP. Os clientes MCP chamam essas ferramentas através do método padrão JSON-RPC tools/call, mas a maioria dos clientes trata disso automaticamente quando você pede uma ação da Ocoya em linguagem natural.

Use primeiro as ferramentas de listagem para obter os IDs de marca, perfil, post, marca, template e workflow. Depois passe esses IDs para as ferramentas de escrita.

{
  "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_brandIdentificar o utilizador autorizado e obter IDs de marca.
Social profilesocoya_list_social_profiles, ocoya_generate_social_connection_url, ocoya_get_social_profileEscolher canais de publicação e iniciar fluxos de ligação de perfis sociais.
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_postEsboçar, gerar, colocar campanhas de IA em fila, inspecionar, atualizar, agendar, publicar e remover conteúdo.
Creative contextocoya_list_hashtag_libraries, ocoya_list_studio_templatesEncontrar bibliotecas de hashtags e templates do Studio para posts gerados.
Workflowsocoya_list_workflows, ocoya_get_workflow, ocoya_toggle_workflow, ocoya_run_workflowInspecionar, ativar, desativar e executar automatizações.
1

Resolve the brand

Chame ocoya_list_brands, opcionalmente com query, e guarde o id devolvido como brandId.

2

Resolve target channels

Para tarefas de publicação, chame ocoya_list_social_profiles com brandId e guarde os socialProfileIds de destino.

3

Resolve optional context

Use ocoya_list_hashtag_libraries ou ocoya_list_studio_templates quando o post deve usar referências de hashtags ou visuais guardadas.

4

Call the write tool

Só crie, atualize, agende, publique, apague, faça toggle ou execute depois de os IDs e a intenção do utilizador estarem claros.

Use datetimes ISO para agendamento:

2026-07-01T09:00:00Z

​
Account and brand

ocoya_get_me

Devolve o utilizador Ocoya autorizado para a autorização OAuth MCP atual.

ocoya_list_brands

Lista ou pesquisa marcas aprovadas para a ligação MCP atual.

ocoya_get_brand

Vai buscar os detalhes de uma marca depois de obter um ID de marca.

​
Social profiles

ocoya_list_social_profiles

Lista canais ligados para uma marca aprovada.

Generate social connection URL

Gera um URL de browser que inicia um novo fluxo de ligação de perfil social.

ocoya_get_social_profile

Vai buscar os detalhes de um perfil social ligado.

​
Posts and calendar

ocoya_list_posts

Pesquisa grupos de posts por estado, legenda e paginação.

ocoya_list_calendar_posts

Lista posts agendados dentro de um intervalo de datas.

ocoya_get_post

Vai buscar todos os detalhes de um grupo de posts.

ocoya_create_post

Cria um rascunho, agenda um post ou publica imediatamente.

ocoya_create_ai_post

Gera um rascunho de IA pronto a editar com referências opcionais de hashtags, perfis e Studio.

ocoya_create_ai_campaign

Coloca em fila a geração de uma campanha de IA com múltiplos posts e devolve imediatamente com estado GENERATING.

ocoya_update_post

Atualiza legenda, agendamento, estado de publicação, media ou perfis sociais associados.

ocoya_schedule_post

Agenda ou reagenda um grupo de posts existente.

ocoya_delete_post

Apaga um grupo de posts e cancela os agendamentos relacionados.

​
Creative context

ocoya_list_hashtag_libraries

Encontra bibliotecas de hashtags reutilizáveis para rascunhos gerados.

ocoya_list_studio_templates

Encontra IDs de templates do Studio para usar como referências visuais.

​
Workflows

ocoya_list_workflows

Lista IDs de workflows e o respetivo estado (ativo/inativo) para uma marca.

ocoya_get_workflow

Vai buscar metadados do workflow e opções de passos.

ocoya_toggle_workflow

Ativa ou desativa um workflow.

ocoya_run_workflow

Coloca em fila uma execução imediata de workflow com input opcional.

​
Write actions

As ferramentas abaixo podem alterar o estado da marca:

  • 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

Revise a intenção do utilizador antes de publicar imediatamente, apagar, alterar workflows ou executar ações de ligação social.