Ocoya MCP
Ocoya MCP lets AI assistants such as Claude, ChatGPT, Gemini, Manus, Codex and VS Code work with your Ocoya account directly. After you approve access, the assistant can read approved brands, list connected channels, create posts, generate drafts with AI, schedule content, publish posts, manage brand context, and run workflows through natural language.
Use MCP when you want an assistant to operate Ocoya safely through approved brand access instead of giving it API keys or asking it to write raw REST calls.
OAuth-approved
Users sign in to Ocoya, review permissions, and choose which brands the MCP client can access.
Brand-scoped
Every brand tool is limited to the brands selected during the OAuth approval flow.
Read and write tools
Clients can discover brand data, create and update posts, schedule content, publish immediately, and run workflows.
No API keys
Ocoya MCP uses OAuth. Ocoya API keys are not accepted by the MCP server.
What can the AI do?
With Ocoya MCP connected, your assistant can:
- Resolve account context — identify the authorized user and list approved brands.
- Read and update the brand — read a brand’s full profile and brand score, and change its description, website, tone of voice, guidelines, SEO keywords, hashtags and colors.
- Choose publishing channels — list connected channels and connect new ones.
- Find and inspect content — list posts, calendar posts, and full post details before making changes.
- Create and update posts — create drafts, attach media, apply channels, schedule content, and update existing post groups.
- Generate AI drafts and campaigns — create ready-to-edit posts or queue multi-post campaign generation, with AI images or the brand’s own Studio design.
- Follow campaigns — list a brand’s campaigns, check generation progress, and read a campaign’s posts.
- Use Studio designs — make post images from the brand’s own designs, with new text, images or colours.
- Run automations — list workflows, inspect workflow details, enable or disable workflows, and queue workflow runs.
How access works
Ocoya MCP is a remote HTTP MCP server:
https://mcp.ocoya.comWhen a client first needs an Ocoya tool, it opens the Ocoya OAuth flow in the browser. The user signs in, reviews the requested scopes, selects allowed brands, and approves the client. The client receives short-lived access tokens and refreshes them according to the OAuth flow.
Approved grants can include:
| Capability | What it allows |
|---|---|
brand:read | Read approved brands, their brand profile and brand score. |
brand:write | Update a brand’s profile: description, website, tone of voice, guidelines, SEO keywords, hashtags and colors. Brand owners and admins only. |
channels:read | Read connected channels in approved brands. |
posts:read | List and inspect posts, calendar content and AI campaigns. |
posts:write | Create drafts and AI campaigns, update posts, schedule posts, and delete posts. |
posts:publish | Publish posts immediately. |
workflows:read | List and inspect workflows. |
workflows:run | Toggle workflows and queue workflow runs. |
offline_access | Refresh access without asking the user to approve every request again. |
Getting started
Open MCP settings
Open the MCP settings page in Ocoya and choose the client you want to connect.
Open MCP settings
Add the MCP server
Configure your client with https://mcp.ocoya.com. See the connection guide for Claude, ChatGPT, Gemini, Manus, Codex, VS Code, and JSON-based clients.
Approve OAuth access
Sign in to Ocoya, review permissions, select the brands the client may access, and approve the connection.
Ask for a small read action first
Ask the client to list your Ocoya brands and connected channels before creating, scheduling, or publishing content.
Recommended first prompts
List my Ocoya brands and show the connected channels in the Acme brand.Create a draft post in Acme with this caption: "Our summer launch is live."Schedule that post for LinkedIn tomorrow at 09:00 in the brand timezone.Show me workflows in Acme and run the product launch workflow with campaignId set to summer-2026.Important: review write actions
MCP clients can perform write actions in the brands you approve. Review client actions before approving sensitive tasks such as immediate publishing, deleting posts, connecting channels, disabling workflows, or running workflows with production inputs.