# ContentStudio MCP MCP

> ContentStudio manages your entire social media content lifecycle. Use this MCP to plan, draft, schedule, and analyze posts across multiple channels—from LinkedIn to Instagram—all in one place. Get performance analytics, manage assets in a central library, and automate publishing without ever opening the native apps.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** content-scheduling, social-publishing, analytics-dashboard, multi-channel, post-management, ai-writing

## Description

Managing social accounts shouldn't mean jumping between five different dashboards just to post an update. This MCP lets your agent handle all that overhead using natural conversation. You can view connected profiles right through your AI client, ensuring everything is linked up first. When you need to publish something, you tell the system what it is and when it needs to go live; it handles creating and scheduling posts for every channel at once. Need to know if a post hit its target? You retrieve detailed engagement metrics, tracking likes, shares, comments, and follower growth per piece of content. It also gives you access to your media library and lets you browse structured categories for planning future campaigns. Because Vinkius hosts this MCP in the catalog, your agent can manage all these workflows without you ever having to worry about API keys or manual setup.

## Tools

### check_contentstudio_status
Verifies if your connection to ContentStudio is active and working correctly.

### create_post
Drafts and schedules a new social media post across specified platforms.

### delete_post
Removes an existing scheduled or published post from any platform.

### get_social_account
Displays specific details about one linked social media account.

### get_analytics
Fetches overall account performance metrics and follower growth data for your connected profiles.

### get_post_analytics
Gets detailed performance data, like likes and shares, for a single post.

### get_post
Retrieves the full details of a specific piece of content post.

### list_social_accounts
Lists all social media profiles connected to ContentStudio, showing their type and follow count.

### list_posts_by_status
Filters and shows only the posts that match a specific status (e.g., 'draft' or 'failed').

### list_categories
List categories

### list_media
Shows you all the images, videos, and files currently stored in your media library.

### list_posts
Retrieves a list of all posts associated with your account(s).

### list_workspaces
Shows you different working areas or organizational units within the platform.

## Prompt Examples

**Prompt:** 
```
Create a LinkedIn and Twitter post about our new product launch for tomorrow at 9am EST.
```

**Response:** 
```
Post created and scheduled! Post ID: post_29401. Content: 'Exciting news — we're launching our newest product tomorrow! Stay tuned for details. #ProductLaunch #Innovation'. Scheduled for April 27 at 9:00 AM EST. Target accounts: LinkedIn (acc_112) and Twitter (acc_115). Would you like me to also add an image from your media library?
```

**Prompt:** 
```
Show me all scheduled posts for this week and their engagement predictions.
```

**Response:** 
```
Filtering by status 'scheduled'... You have 8 posts queued this week. Monday: 2 posts (LinkedIn case study, Instagram reel). Tuesday: 1 post (Twitter thread). Wednesday: 2 posts (LinkedIn carousel, Facebook announcement). Thursday: 1 post (Instagram story). Friday: 2 posts (LinkedIn article, Twitter poll). Would you like to see the content of any specific post or modify the schedule?
```

**Prompt:** 
```
What were the top performing posts on our Instagram account last month?
```

**Response:** 
```
Fetching analytics for Instagram account (acc_118)... Your top 3 posts last month by engagement: 1) Product demo reel — 12,400 impressions, 842 likes, 156 comments. 2) Behind-the-scenes story — 9,200 impressions, 621 likes, 89 saves. 3) Customer testimonial carousel — 8,100 impressions, 534 likes, 72 shares. Total follower growth: +1,240 (3.2% increase). Would you like detailed analytics for any specific post?
```

## Capabilities

### Manage accounts
List and view details for every connected social media profile.

### Schedule content
Create, schedule, list, or delete posts across multiple platforms simultaneously.

### Track performance metrics
Retrieve detailed engagement data and account growth analytics for specific campaigns or time periods.

### Organize media assets
Browse your centralized library of images, videos, and files for reuse in new posts.

## Use Cases

### Need to report Q2 performance
The marketing team needs a consolidated view of last quarter's best-performing posts. They ask their agent to run `get_analytics` and then use `get_post_analytics` on the top three items, getting all metrics (likes, shares) in one report instead of manually pulling them from three different platform dashboards.

### Launching a product campaign
A content creator needs to launch a coordinated campaign across LinkedIn and Twitter. They ask their agent to run `list_social_accounts` to confirm credentials, then use `create_post` repeatedly for each platform with the correct timing.

### Cleaning up old posts
An account manager realizes a few scheduled announcements are outdated. They ask their agent to use `list_posts_by_status` filtered by 'scheduled,' identify the bad ones, and then run `delete_post` on those specific IDs.

### Building out content pillars
A strategist is planning a whole month of evergreen content. They first use `list_users` to see available categories, then use `list_media` to grab relevant assets and finally draft multiple posts using `create_post` for different platforms.

## Benefits

- Stop switching tabs. You can create, schedule, and list posts for Instagram, Twitter, LinkedIn, and Facebook simultaneously using `create_post` and `list_posts_by_status`.
- You always know what's working. Pull deep performance data by calling `get_analytics` to track overall growth or use `get_post_analytics` on a single piece of content.
- Never lose an asset. Access your centralized media library via `list_media`, so you can reference old videos and images when drafting new copy with zero friction.
- Keep tabs on everything without logging in. Use `list_social_accounts` to view connection status for all profiles, ensuring no platform falls through the cracks before a major campaign launch.
- Stay organized by content type. You can use `list_users` and browse categories to structure your content planning months ahead of time.

## How It Works

The bottom line is you treat your social media dashboard like another chat window; you just talk to it.

1. Subscribe to this MCP and provide your ContentStudio API Key through your client settings.
2. Your agent accesses the connected accounts data using tools like `list_social_accounts` to verify all profiles are active and linked.
3. You send a natural language command, and the agent uses multiple endpoints—like `create_post` or `get_analytics`—to execute the full workflow.

## Frequently Asked Questions

**How do I check if my connection is working using the check_contentstudio_status tool?**
Simply run `check_contentstudio_status`. This verifies your API key and connectivity right away. It's a quick way to make sure you don't waste time trying to schedule posts on a dead account.

**Can I see all my scheduled posts at once with list_posts_by_status?**
Yes, `list_posts_by_status` lets you filter the entire queue. You can pull up drafts, or just failed posts, so you know exactly what needs fixing without scrolling through months of content.

**What kind of data does get_post_analytics give me?**
`get_post_analytics` provides granular detail on a single post. You'll see specific numbers for likes, shares, comments, and impressions, helping you figure out which content types perform best.

**Does list_social_accounts show me everything?**
It lists every social media profile connected to the MCP. You'll see the platform type and follower count right there, giving you a quick health check on your entire digital footprint.

**If I run list_social_accounts, what error should I expect if my API key is expired or invalid?**
The system will return a clear authentication failure code. This means the connection isn't seeing your credentials right. You need to check your ContentStudio profile and generate a new API Key for the MCP.

**When I use get_post, what fields does it provide about the content structure?**
It gives you granular details on the post, including its full text, associated media IDs, target platforms, and current status (like draft or published). This helps verify exactly how the content is formatted.

**Are there any rate limits when I use create_post for bulk scheduling?**
While we handle large volumes, ContentStudio imposes limits to prevent spamming. If you try to schedule too many posts in a short burst, the system will tell you exactly how long you need to wait before trying again.

**After listing media with list_media, how do I ensure those files are available for my post?**
Listing just shows what's there. To actually use the images or videos, you must pass the specific Media IDs returned by the tool when calling create_post. This links the file to the draft content.

**Can I create and schedule posts to multiple social accounts at once?**
Yes! The `create_post` action accepts a JSON payload with content, media attachments, schedule date, and target account IDs. You can publish to Instagram, Twitter, LinkedIn, and Facebook simultaneously in a single command.

**Can I track how individual posts are performing?**
Yes. Use `get_post_analytics` with a specific Post ID to retrieve likes, shares, comments, impressions, and reach for that post. For account-wide metrics, use `get_analytics` with the Social Account ID to see follower growth, engagement rates, and top-performing content.

**Can I filter posts by their publishing status?**
Yes. The `list_posts_by_status` tool accepts a status parameter — 'draft', 'scheduled', 'published', or 'failed'. This lets you quickly find posts that need review (drafts), are queued for delivery (scheduled), or encountered errors during publishing (failed).