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 brand, 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_brands",
    "arguments": {}
  }
}

Tool categories

Category	Tools	Typical use
Account and brand	`ocoya_get_me`, `ocoya_list_brands`, `ocoya_get_brand`	Identify the authorized user and resolve brand 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.
Creative context	`ocoya_list_hashtag_libraries`, `ocoya_list_studio_templates`	Find 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 brand

Call ocoya_list_brands, optionally with query, and keep the returned id as brandId.

Resolve target channels

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

Resolve optional context

Use ocoya_list_hashtag_libraries or ocoya_list_studio_templates when the post should use saved 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 brand

ocoya_get_me

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

ocoya_list_brands

List or search brands approved for the current MCP connection.

ocoya_get_brand

Fetch brand details after resolving a brand ID.

ocoya_list_social_profiles

List connected channels for an approved brand.

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 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, 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.

Creative context

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 brand.

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 brand 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 brand