Skip to main content

​
MCP Tools

Ocoya exposes 23 MCP tools. MCP clients call these tools through the standard tools/call JSON-RPC method, but most clients handle this automatically when you ask for an Ocoya action in natural language. 
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "ocoya_list_workspaces",
    "arguments": {}
  }
}

​
Tool Categories

CategoryToolsTypical use
Account and workspaceocoya_get_me, ocoya_list_workspaces, ocoya_get_workspaceResolve the authorized user and workspace IDs.
Social profilesocoya_list_social_profiles, ocoya_get_social_connection_url, ocoya_get_social_profileConnect channels and choose where posts should be published.
Postsocoya_list_posts, ocoya_list_calendar_posts, ocoya_get_post, ocoya_preview_post, ocoya_update_post, ocoya_create_post, ocoya_create_ai_post, ocoya_schedule_post, ocoya_publish_post, ocoya_delete_postDraft, generate with AI, inspect, schedule, publish, and remove posts.
Brand, hashtag, and Studio contextocoya_list_brand_kits, ocoya_list_hashtag_libraries, ocoya_list_studio_templatesFind brand kit, hashtag library, and Studio design IDs to attach to generated posts.
Workflowsocoya_list_workflows, ocoya_get_workflow, ocoya_toggle_workflow, ocoya_run_workflowInspect, enable, disable, and run automations.

​
Common Flow

1

Resolve the workspace

Use ocoya_list_workspaces, optionally with query, and keep the returned id.
2

Resolve social profiles

For posting tasks, call ocoya_list_social_profiles with workspaceId and keep the target profile IDs.
3

Create or inspect content

Use post tools with the resolved workspaceId, socialProfileIds, and any post or workflow IDs returned by list tools.
Use ISO datetimes for scheduling. 
2026-07-01T09:00:00Z

​
Tool Reference

ocoya_get_me

Get the Ocoya user associated with the MCP OAuth grant.

ocoya_list_workspaces

List or search workspaces allowed by the MCP OAuth grant.

ocoya_get_social_connection_url

Get a browser URL to connect a social network.

ocoya_create_post

Create a draft, scheduled post, or immediate publishing job.

ocoya_create_ai_post

Generate a ready-to-edit Ocoya draft post from a prompt using AI.

ocoya_list_hashtag_libraries

Find reusable hashtag library IDs for generated posts.

ocoya_list_studio_templates

Find Studio design IDs for AI image references.

ocoya_run_workflow

Queue an Ocoya workflow run immediately.