# Ocoya Social Media MCP

> Ocoya Social Media MCP Server handles content scheduling, profile management, and workflow tracking across your social channels. It lets your AI client read user profiles, list all posts, view active automations, and manage multiple workspaces from one connection point.

## Overview
- **Category:** marketing-automation
- **Price:** Free
- **Tags:** content-scheduling, social-media-management, marketing-workflows, post-analytics, workspace-management

## Description

Yo. Look, this **Ocoya Social Media MCP Server** gives your AI client the straight dope on all your social media stuff—profiles, posts, and automated workflows. You don't wanna deal with a bunch of different dashboards; you just want one connection point that handles everything.

When you connect it, you get full access to manage your entire content marketing stack through your agent. It lets your client check out what profiles are linked up, see every post—whether it went live or's sitting there waiting to go out—and audit all the automations running in the background. You’re talking about controlling multiple workspaces without logging into anything else.

**Managing Workspaces and Profiles**

Want a rundown of your whole account setup? Use `list_workspaces` to grab a list of every workspace you've got configured in Ocoya. If you need the nitty-gritty on one specific area, run `get_workspace` and give it the name, and it’ll spit out those detailed settings. To see what social channels are even connected, use `list_profiles`; this lists all your linked profiles so you know which accounts are ready to rock.

If you need deep details on a specific account—say, LinkedIn or Twitter—you run `get_profile` and it pulls back the full data and connection status for that one profile. It's how your agent knows if everything's legit and connected right.

**Tracking Content and Posts**

Dealing with content is a whole other ballgame. To get a comprehensive view of everything you've posted, use `list_posts`. This tool gives you a paginated list that includes both posts that are already published *and* those scheduled for the future. It’s your central feed.

If you only care about one piece of content—maybe you wanna check up on a specific campaign post—you use `get_post` and pass in its unique ID, and it returns all the content details for that single item. No guesswork required here.

**Auditing Automations and Workflows**

For the automated side of things, your agent can give you full visibility into what's running. To see a summary of every marketing workflow or automation active in your account, just run `list_automations`. That gives you the overview.

If you need to dive deep into one specific piece of tech, use `get_automation`. You feed it the name of the workflow, and it retrieves detailed information about that exact setup. This lets you see exactly how a particular automation is configured.

**User Context**

Finally, your agent needs to know who's running the show. To authenticate and get basic info on the user currently operating the system, run `get_me`. It confirms your identity and provides necessary authentication details within the Ocoya platform.

## Tools

### get_automation
Retrieves detailed information for one specific marketing workflow or automation.

### get_me
Gets the basic profile and authentication info for the user currently running the agent.

### get_post
Fetches all content details for a specific post using its unique ID.

### get_profile
Retrieves full data and connection status for one social media profile (e.g., LinkedIn or Twitter).

### get_workspace
Gets the specific details of a named workspace within your Ocoya account.

### list_automations
Returns a list summary of all automations and workflows currently active in your account.

### list_posts
Provides a paginated list of content posts, including both published and scheduled items.

### list_profiles
Lists all social media profiles connected to your Ocoya account so you know what channels are live.

### list_workspaces
Returns a list of every workspace configured in the Ocoya platform.

## Prompt Examples

**Prompt:** 
```
Retrieve all my scheduled marketing posts for the Black Friday campaign running on my Ocoya workspace.
```

**Response:** 
```
I've retrieved your scheduled posts. You have 4 upcoming posts for the Black Friday campaign, including '50% Off Sitewide Announcement' set for Twitter and 'Midnight Flash Sale' queued for LinkedIn. Would you like me to pause any of these?
```

**Prompt:** 
```
Check which social media profiles are currently connected and active in my main Ocoya workspace.
```

**Response:** 
```
I found 3 active social profiles connected to your workspace: '@VinkiusLabs' (Twitter), 'Vinkius Official' (LinkedIn Company Page), and 'Vinkius Design' (Instagram Business). The connection status for all 3 is currently healthy.
```

**Prompt:** 
```
Show me all active marketing workflows and automations running in my Ocoya account right now.
```

**Response:** 
```
I found 3 active automations in your Ocoya account: 'Blog to Twitter Sync', 'Weekly Newsletter Promo', and 'Instagram Story Cross-post'. All triggers are functioning normally. Would you like to view the execution history of a specific workflow?
```

## Capabilities

### Retrieve Workspace Data
Get a list or specific details about the overall workspaces configured in your Ocoya account.

### Manage User Profiles
List all connected social profiles or retrieve detailed information for one specific profile (e.g., Twitter, LinkedIn).

### Fetch Content Posts
Retrieve a list of published posts or fetch the full details for a single post by its ID.

### Audit Automations
List all available marketing workflows and read the settings for specific automations using `get_automation`.

### Identify User Context
Authenticate your agent and get the current user's information within the Ocoya system.

## Use Cases

### Checking Campaign Status
A manager needs to know how many posts are ready for the upcoming holiday campaign. They ask their agent, which runs `list_posts`. The agent returns a list summary of all content statuses (drafted, scheduled, published), letting the manager see exactly what's done and what's left.

### Debugging Automation Failure
An automated workflow stopped sending emails. Instead of hunting through logs, the agent runs `get_automation` using the workflow ID. This quickly reveals the last successful step or a specific error message, allowing for rapid fixes.

### Client Onboarding Audit
A new client account needs to be reviewed before launch. The agent runs `list_workspaces` and then calls `get_profile` for each listed channel. This confirms that all required social profiles are connected and active.

### Data Dump for Reporting
The analytics team needs a list of every post published last quarter. The agent uses `list_posts` to pull the historical data, providing structured, clean results that can be dropped right into a spreadsheet.

## Benefits

- Audit all workflows at once. Use `list_automations` to see every marketing workflow running without opening the web dashboard.
- Check profile health immediately. Run `get_profile` on a specific channel name to confirm connection status, which is faster than clicking through settings.
- Get content history instantly. Call `list_posts` to pull a summary of all scheduled and published posts for a campaign review.
- See your current context. Use `get_me` first to verify the agent is running under the correct user's permissions before executing major commands.
- Map out your setup. Run `list_workspaces` and `list_profiles` together to get a complete inventory of every site you manage through Ocoya.

## How It Works

The bottom line is: your AI client talks to us, we talk to Ocoya, and we send you clean data.

1. Provide your API Key to Vinkius. Your AI client uses this key to authenticate with the Ocoya platform.
2. The agent calls a specific tool (e.g., `list_workspaces`). The server executes that function against the live Ocoya data.
3. Your agent receives structured JSON data describing the profiles, posts, or automations you asked for.

## Frequently Asked Questions

**How do I see all my connected social media accounts with Ocoya Social Media MCP Server?**
You run `list_profiles`. This tool returns an inventory of every profile linked to your account, letting you know exactly which channels are currently managed.

**Does the get_automation tool only show active workflows?**
No. You first use `list_automations` for a summary list, and then you call `get_automation(id='...')` to pull detailed information on any specific workflow, whether it's active or paused.

**What is the difference between list_posts and get_post?**
`list_posts` gives you a summary view of many posts—useful for seeing campaign volume. `get_post` fetches the complete, deep data object for one specific post ID.

**Can I check my user account info with get_me?**
Yes. Calling `get_me` verifies your current authentication credentials and provides basic user details, confirming your agent's context before you run other commands.

**When I use the `get_workspace` tool, what scope of data does it retrieve?**
It retrieves metadata about the workspace itself, like its name, creation date, and owner. It won't pull post content or profile details; you need separate calls to list those specific assets.

**If I use `get_profile` with an ID that doesn't exist, what happens?**
The tool immediately returns a clear error message. Your agent knows the Profile ID is invalid or inaccessible, stopping the workflow right there instead of failing silently.

**What kind of parameters does `get_automation` require to run?**
It requires a unique automation identifier (ID) and must be called within an authenticated workspace context. This ensures your agent gets the exact workflow you're looking for.

**When calling `list_posts`, how can I filter the results to narrow down my search?**
You typically pass optional filters like a date range or specific profile ID. This lets your agent pull only the posts you care about, instead of dumping every single post record.

**Where do I find my API Key?**
Your API Key can be generated in the Ocoya Developer or Integrations settings page.

**What access does this MCP need?**
It requires your API Key to access your profiles, workspaces, and posts.