​
MCP tools

Ocoya expone 22 herramientas MCP. Los clientes MCP llaman a estas herramientas mediante el método estándar JSON-RPC tools/call, pero la mayoría de clientes gestionan esto automáticamente cuando les pides en lenguaje natural que hagan algo en Ocoya.

Usa primero las herramientas de listado para resolver los IDs de brand, profile, post, brand, template y workflow. Luego pasa esos IDs a las herramientas de escritura.

{
  "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 al usuario autorizado y resolver IDs de brand.
Social profilesocoya_list_social_profiles, ocoya_generate_social_connection_url, ocoya_get_social_profileElegir canales de publicación e iniciar flujos de conexión de perfiles sociales.
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_postRedactar, generar, poner en cola campañas de IA, inspeccionar, actualizar, programar, publicar y eliminar contenido.
Creative contextocoya_list_hashtag_libraries, ocoya_list_studio_templatesEncontrar bibliotecas de hashtags y plantillas de Studio para posts generados.
Workflowsocoya_list_workflows, ocoya_get_workflow, ocoya_toggle_workflow, ocoya_run_workflowInspeccionar, activar, desactivar y ejecutar automatizaciones.
1

Resolve the brand

Llama a ocoya_list_brands, opcionalmente con query, y conserva el id devuelto como brandId.

2

Resolve target channels

Para tareas de publicación, llama a ocoya_list_social_profiles con brandId y conserva los socialProfileIds de destino.

3

Resolve optional context

Usa ocoya_list_hashtag_libraries o ocoya_list_studio_templates cuando el post deba usar referencias guardadas de hashtags o visuales.

4

Call the write tool

Crea, actualiza, programa, publica, elimina, alterna o ejecuta solo cuando los IDs y la intención del usuario estén claros.

Usa datetimes ISO para la programación:

2026-07-01T09:00:00Z

​
Account and brand

ocoya_get_me

Devuelve el usuario de Ocoya autorizado para la concesión OAuth MCP actual.

ocoya_list_brands

Lista o busca brands aprobadas para la conexión MCP actual.

ocoya_get_brand

Recupera los detalles de una brand después de resolver su ID.

​
Social profiles

ocoya_list_social_profiles

Lista los canales conectados para una brand aprobada.

Generate social connection URL

Genera una URL de navegador que inicia un nuevo flujo de conexión de perfil social.

ocoya_get_social_profile

Recupera los detalles de un perfil social conectado.

​
Posts and calendar

ocoya_list_posts

Busca grupos de posts por estado, caption y paginación.

ocoya_list_calendar_posts

Lista posts programados dentro de un rango de fechas.

ocoya_get_post

Recupera todos los detalles de un grupo de posts.

ocoya_create_post

Crea un borrador, programa un post o publica inmediatamente.

ocoya_create_ai_post

Genera un borrador de IA listo para editar con referencias opcionales de hashtags, perfiles y Studio.

ocoya_create_ai_campaign

Pone en cola la generación de una campaña de IA con varios posts y devuelve la respuesta inmediatamente con estado GENERATING.

ocoya_update_post

Actualiza la caption, la programación, el estado de publicación, los medios o los perfiles sociales vinculados.

ocoya_schedule_post

Programa o reprograma un grupo de posts existente.

ocoya_delete_post

Elimina un grupo de posts y cancela las programaciones relacionadas.

​
Creative context

ocoya_list_hashtag_libraries

Encuentra bibliotecas de hashtags reutilizables para borradores generados.

ocoya_list_studio_templates

Encuentra IDs de plantillas de Studio para usarlas como referencias visuales.

​
Workflows

ocoya_list_workflows

Lista los IDs de workflows y su estado (activado) para una brand.

ocoya_get_workflow

Recupera los metadatos del workflow y las opciones de sus pasos.

ocoya_toggle_workflow

Activa o desactiva un workflow.

ocoya_run_workflow

Pone en cola una ejecución inmediata de un workflow con input opcional.

​
Write actions

Las herramientas siguientes pueden cambiar el estado de una 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

Revisa la intención del usuario antes de publicar o eliminar de inmediato, cambiar workflows o realizar acciones de conexión social.