MCP tools

Ocoya exposes 22 MCP tools. MCP clients call these tools through the standard tools/call JSON-RPC method, but most clients handle that automatically when you ask for an Ocoya action in natural language. Use list tools first to resolve workspace, profile, post, brand, template, and workflow IDs. Then pass those IDs to write tools.

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

Tool categories

Category	Tools	Typical use
Account and workspace	`ocoya_get_me`, `ocoya_list_workspaces`, `ocoya_get_workspace`	Identify the authorized user and resolve workspace IDs.
Social profiles	`ocoya_list_social_profiles`, `ocoya_generate_social_connection_url`, `ocoya_get_social_profile`	Choose publishing channels and start social profile connection flows.
Posts and calendar	`ocoya_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_post`	Draft, generate, queue AI campaigns, inspect, update, schedule, publish, and remove content.
Brand and creative context	`ocoya_list_brand_kits`, `ocoya_list_hashtag_libraries`, `ocoya_list_studio_templates`	Find brand kits, hashtag libraries, and Studio templates for generated posts.
Workflows	`ocoya_list_workflows`, `ocoya_get_workflow`, `ocoya_toggle_workflow`, `ocoya_run_workflow`	Inspect, enable, disable, and run automations.

Recommended flow

Resolve the workspace

Call ocoya_list_workspaces, optionally with query, and keep the returned id as workspaceId.

Resolve target channels

For publishing tasks, call ocoya_list_social_profiles with workspaceId and keep the target socialProfileIds.

Resolve optional context

Use ocoya_list_brand_kits, ocoya_list_hashtag_libraries, or ocoya_list_studio_templates when the post should use saved brand, hashtag, or visual references.

Call the write tool

Create, update, schedule, publish, delete, toggle, or run only after the IDs and user intent are clear.

Use ISO datetimes for scheduling:

2026-07-01T09:00:00Z

Account and workspace

ocoya_get_me

Return the authorized Ocoya user for the current MCP OAuth grant.

ocoya_list_workspaces

List or search workspaces approved for the current MCP connection.

ocoya_get_workspace

Fetch workspace details after resolving a workspace ID.

ocoya_list_social_profiles

List connected channels for an approved workspace.

Generate social connection URL

Generate a browser URL that starts a new social profile connection flow.

ocoya_get_social_profile

Fetch details for one connected social profile.

Posts and calendar

ocoya_list_posts

Search post groups by status, caption, and pagination.

ocoya_list_calendar_posts

List scheduled posts within a date range.

ocoya_get_post

Fetch full details for one post group.

ocoya_create_post

Create a draft, schedule a post, or publish immediately.

ocoya_create_ai_post

Generate a ready-to-edit AI draft with optional brand, hashtag, profile, and Studio references.

ocoya_create_ai_campaign

Queue generation for a multi-post AI campaign and return immediately with GENERATING status.

ocoya_update_post

Update caption, schedule, publish state, brand kit, media, or attached social profiles.

ocoya_schedule_post

Schedule or reschedule an existing post group.

ocoya_delete_post

Delete a post group and cancel related schedules.

Brand and creative context

ocoya_list_brand_kits

Find brand kit IDs to apply brand context to content.

ocoya_list_hashtag_libraries

Find reusable hashtag libraries for generated drafts.

ocoya_list_studio_templates

Find Studio template IDs to use as visual references.

Workflows

ocoya_list_workflows

List workflow IDs and enabled state for a workspace.

ocoya_get_workflow

Fetch workflow metadata and step options.

ocoya_toggle_workflow

Enable or disable a workflow.

ocoya_run_workflow

Queue an immediate workflow run with optional input.

Write actions

The tools below can change workspace state:

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

Review the user’s intent before immediate publishing, deletion, workflow changes, or social connection actions.

​MCP tools

​Tool categories

​Recommended flow

​Account and workspace