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 brands, 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 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.
- 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 hashtag libraries and Studio template references.
- Use creative context — list 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:
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 and related brand context. |
social_profiles:read | Read connected social profiles in approved brands. |
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 settingsAdd 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 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 social profiles before creating, scheduling, or publishing content.
Recommended first prompts
List my Ocoya brands and show the connected social profiles 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 social profiles, disabling workflows, or running workflows with production inputs.