Ocoya MCP
Ocoya MCP lets AI assistants such as Claude, ChatGPT, Codex, and VS Code work with your Ocoya account directly. After you approve access, the assistant can read approved workspaces, list connected social profiles, 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 workspace 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 workspaces the MCP client can access.
Workspace-scoped
Every workspace tool is limited to the workspaces selected during the OAuth approval flow.
Read and write tools
Clients can discover workspace 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 workspaces.
- Choose publishing channels — list connected social profiles and start new social connection flows.
- Find and inspect content — list posts, calendar posts, and full post details before making changes.
- Create and update posts — create drafts, attach media, apply social profiles, schedule content, and update existing post groups.
- Generate AI drafts and campaigns — create ready-to-edit posts or queue multi-post campaign generation with optional brand kits, hashtag libraries, and Studio template references.
- Use brand context — list brand kits, hashtag libraries, and Studio templates for more consistent content.
- 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:| Capability | What it allows |
|---|---|
workspace:read | Read approved workspaces and related workspace context. |
social_profiles:read | Read connected social profiles in approved workspaces. |
posts:read | List and inspect posts and calendar content. |
posts:write | Create drafts, 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, Codex, VS Code, and JSON-based clients.Approve OAuth access
Sign in to Ocoya, review permissions, select the workspaces the client may access, and approve the connection.
Recommended first prompts
Important: review write actions
MCP clients can perform write actions in the workspaces you approve. Review client actions before approving sensitive tasks such as immediate publishing, deleting posts, connecting social profiles, disabling workflows, or running workflows with production inputs.Next
What is MCP?
Learn how MCP connects AI clients to Ocoya tools through approved workspace access.
Connect Ocoya MCP
Configure Ocoya MCP in Claude, ChatGPT, Codex, VS Code, and JSON-based clients.
MCP tools
Review every Ocoya MCP tool, parameter, request example, and return shape.