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
| Category | Tools | Typical use |
|---|---|---|
| Account and brand | ocoya_get_me, ocoya_list_brands, ocoya_get_brand, ocoya_update_brand | Identify the authorized user, resolve brand IDs, and read or update a brand’s profile and score. |
| Channels | ocoya_list_channels, ocoya_generate_channel_connection_url, ocoya_get_channel | Choose publishing channels and start channel 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_schedule_post, ocoya_delete_post | Draft, generate, inspect, update, schedule, publish, and remove content. |
| Campaigns | ocoya_create_ai_campaign, ocoya_list_campaigns, ocoya_get_campaign | Queue AI campaigns, follow their generation, and read their posts. |
| Studio | ocoya_list_studio_designs, ocoya_get_studio_design, ocoya_render_studio_design, ocoya_list_studio_templates | Make post images from the brand’s own Studio designs, or find gallery templates to use as visual references. |
| Workflows | ocoya_list_workflows, ocoya_get_workflow, ocoya_toggle_workflow, ocoya_run_workflow | Inspect, enable, disable, and run automations. |
| SEO posts | ocoya_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_post | Write 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. |
ocoya_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_campaign | Write 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. | |
| Contacts | ocoya_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_group | Add, import and change the people your emails go to, unsubscribe them, and sort them into groups. |
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_channels with brandId and keep the target channelIds.
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.
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:00ZAccount 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 a brand’s full profile, brand score and suggested next step.
ocoya_update_brand
Change a brand’s description, website, tone, guidelines, keywords, hashtags or colors.
Channels
ocoya_list_channels
List connected channels for an approved brand.
Generate channel connection URL
Generate a browser URL that starts a new channel connection flow.
ocoya_get_channel
Fetch details for one connected channel.
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 channels, AI images, or the brand’s own Studio design.
ocoya_update_post
Update caption, schedule, publish state, media, or attached channels.
ocoya_schedule_post
Schedule or reschedule an existing post group.
ocoya_delete_post
Delete a post group and cancel related schedules.
Campaigns
ocoya_create_ai_campaign
Queue generation for a multi-post AI campaign and return immediately with GENERATING status.
ocoya_list_campaigns
List a brand’s campaigns with their status and generation progress.
ocoya_get_campaign
Fetch one campaign with its posts and their post IDs.
Studio
ocoya_list_studio_designs
List the designs the brand saved in Studio.
ocoya_get_studio_design
See the text, image and colour fields a design accepts.
ocoya_render_studio_design
Render a design with new text, images or colours and get the image URL.
ocoya_list_studio_templates
Find gallery 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_update_brandocoya_create_postocoya_create_ai_postocoya_create_ai_campaignocoya_update_postocoya_schedule_postocoya_delete_post- Generate channel connection URL
ocoya_toggle_workflowocoya_run_workflow
Review the user’s intent before immediate publishing, deletion, workflow changes, or social connection actions.