Skip to main content

​
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:
When 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 workspaces, and approves the client. The client receives short-lived access tokens and refreshes them according to the OAuth flow. Approved grants can include:

​
Getting started

1

Open MCP settings

Open the MCP settings page in Ocoya and choose the client you want to connect.Open MCP settings
2

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.
3

Approve OAuth access

Sign in to Ocoya, review permissions, select the workspaces the client may access, and approve the connection.
4

Ask for a small read action first

Ask the client to list your Ocoya workspaces and connected social profiles before creating, scheduling, or publishing content.

​
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.