MCP tools

Ocoya’s MCP tools are grouped below, each with its own page. 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, channel, post, campaign, 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

CategoryToolsTypical use
Account and brandocoya_get_me, ocoya_list_brands, ocoya_get_brand, ocoya_update_brandIdentify the authorized user, resolve brand IDs, and read or update a brand’s profile and score.
Channelsocoya_list_channels, ocoya_generate_channel_connection_url, ocoya_get_channelChoose publishing channels and start channel connection flows.
Posts and calendarocoya_list_posts, ocoya_list_calendar_posts, ocoya_get_post, ocoya_update_post, ocoya_create_post, ocoya_create_ai_post, ocoya_schedule_post, ocoya_delete_postDraft, generate, inspect, update, schedule, publish, and remove content.
Campaignsocoya_create_ai_campaign, ocoya_list_campaigns, ocoya_get_campaignQueue AI campaigns, follow their generation, and read their posts.
Studioocoya_list_studio_designs, ocoya_get_studio_design, ocoya_render_studio_design, ocoya_list_studio_templatesMake post images from the brand’s own Studio designs, or find gallery templates to use as visual references.
Workflowsocoya_list_workflows, ocoya_get_workflow, ocoya_toggle_workflow, ocoya_run_workflowInspect, enable, disable, and run automations.
SEO postsocoya_list_seo_posts, ocoya_get_seo_post, ocoya_create_seo_post, ocoya_create_ai_seo_post, ocoya_update_seo_post, ocoya_schedule_seo_post, ocoya_delete_seo_postWrite blog articles yourself or with AI, with SEO fields and thumbnails, and schedule or publish them to blog and site channels. SEO campaigns are made with ocoya_create_ai_campaign and type seo.
Emailocoya_list_emails, ocoya_get_email, ocoya_create_email, ocoya_create_ai_email, ocoya_update_email, ocoya_schedule_email, ocoya_delete_email, ocoya_send_test_email, ocoya_get_email_stats, ocoya_list_email_templates, ocoya_get_email_settings, ocoya_schedule_email_campaign, ocoya_unschedule_email_campaignWrite emails yourself or with AI, test, schedule and send them to your contacts, and see how they did. Email campaigns are made with ocoya_create_ai_campaign and type email.
Contactsocoya_list_contacts, ocoya_get_contact, ocoya_create_contact, ocoya_import_contacts, ocoya_update_contact, ocoya_delete_contact, ocoya_bulk_update_contacts, ocoya_list_contact_groups, ocoya_create_contact_group, ocoya_update_contact_group, ocoya_delete_contact_groupAdd, import and change the people your emails go to, unsubscribe them, and sort them into groups.
1

Resolve the brand

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

2

Resolve target channels

For publishing tasks, call ocoya_list_channels with brandId and keep the target channelIds.

3

Resolve optional context

Use ocoya_get_brand for the brand’s voice, keywords and hashtags, and ocoya_list_studio_designs when the post should use one of the brand’s own designs.

4

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

Channels

Posts and calendar

Campaigns

Studio

Workflows

Write actions

The tools below can change brand state:

  • ocoya_update_brand
  • ocoya_create_post
  • ocoya_create_ai_post
  • ocoya_create_ai_campaign
  • ocoya_update_post
  • ocoya_schedule_post
  • ocoya_delete_post
  • Generate channel connection URL
  • ocoya_toggle_workflow
  • ocoya_run_workflow

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