# Planly MCP

> Planly connects your AI client directly to a social media management system. Use Planly to schedule, draft, and publish content across Instagram, TikTok, X/Twitter, and LinkedIn using natural language commands. It lets you list connected channels, pull analytics data, upload media assets, and manage drafts—all from your chat interface. No more logging into dashboards; your AI agent handles the whole publishing lifecycle.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** social-media-scheduling, content-calendar, auto-publishing, multi-channel-marketing, media-management

## Description

This server hooks your AI client up straight to a social media management system. You use Planly to schedule, draft, and publish content across Instagram, TikTok, X/Twitter, and LinkedIn just by talking to it. Forget logging into ten different dashboards; your agent handles the whole publishing lifecycle from your chat window.

When you start, you can get a full picture of what's connected. You use `list_channels` to pull a list of every active social media account tied to your Planly profile, and if you manage multiple groups, `list_teams` shows you all the different team profiles linked up. This confirms everything is synced.

Need content? First, you can have the AI spit out ideas or full captions using `ai_generate_content`. If you want a solid starting point that needs your eyes on it, use `create_draft` to generate a preliminary social media post draft ready for human review. For handling media assets, the system lets you kick off an upload batch with `start_media_upload`, and once all your photos or videos are up, running `finish_media_upload` makes them available for scheduling.

To get posts live, you use natural language to tell the agent exactly what you want. You run `create_schedule` when you're ready to schedule a new, finalized post to go live on a specific platform and date. If something changes, or if that scheduled post is wrong, you can wipe it clean using `delete_schedule`. You also never lose track of what's coming up; running `list_schedules` gives you a complete list of every single post across all channels, while `get_schedule` pulls the specific date, time, and content for just one scheduled item.

When it comes to checking performance, you pull metrics right in your chat. You use `list_analytics` to grab performance data and key metrics for any connected social media channel you specify. To see your whole pipeline at a glance, running `list_schedules` gives you the full picture of what's queued up across every platform.

## Tools

### ai_generate_content
Generates initial post ideas, captions, or full content drafts using AI commands.

### create_draft
Creates a preliminary social media post draft that is ready for human review before scheduling.

### create_schedule
Schedules a new, finalized post to go live on a specific platform and date.

### delete_schedule
Removes an existing scheduled post from your content calendar entirely.

### finish_media_upload
Finalizes the media upload process for images or videos, making them available to schedule.

### get_schedule
Retrieves specific details (date, time, content) for a single scheduled post.

### list_analytics
Pulls performance data and metrics for any connected social media channel you specify.

### list_channels
Lists all the active, connected social media accounts tied to your Planly profile.

### list_schedules
Returns a comprehensive list of every scheduled post across all monitored channels.

### list_teams
Lists the different team profiles connected to your social media account.

### start_media_upload
Initiates the process of uploading a batch of images or videos for later use in posts.

## Prompt Examples

**Prompt:** 
```
List all active social channels in Planly.
```

**Response:** 
```
I've retrieved your channels. You have 3 connected profiles: 'Instagram Main', 'Twitter Biz', and 'LinkedIn Page'. Which one would you like to schedule a post for?
```

**Prompt:** 
```
Show me all posts scheduled for the next 7 days across all my social media channels.
```

**Response:** 
```
18 posts scheduled across your 4 connected channels for the next 7 days. Instagram: 6 posts (3 reels, 2 carousels, 1 story). Twitter/X: 5 tweets including 2 threads. LinkedIn: 4 articles and company updates. TikTok: 3 videos. Tomorrow has the highest density with 5 posts between 9 AM and 6 PM. 2 posts are missing captions and need attention before publishing.
```

**Prompt:** 
```
Schedule a new Instagram carousel post for Thursday at 10 AM with AI-generated caption.
```

**Response:** 
```
Carousel post scheduled for Thursday, May 22nd at 10:00 AM on Instagram (@yourbrand). 4 images uploaded and ordered. AI-generated caption: "Transform your workspace into a productivity powerhouse. Swipe to discover 4 essential design principles that top performers swear by." Hashtags auto-suggested: #WorkspaceDesign #Productivity #OfficeGoals #RemoteWork (reach estimate: 12K). First comment scheduled with additional hashtags.
```

## Capabilities

### List and Sync Channels
Your agent retrieves a list of all connected social media accounts, confirming which platforms are active.

### Generate & Draft Content
You prompt the system to generate post ideas or create full drafts ready for review on multiple channels.

### Manage Media Assets
The agent initiates and finalizes media uploads (photos, videos) directly within the chat environment.

### Create & Modify Schedules
You schedule new posts or delete existing ones by specifying the platform and time in natural language.

### Retrieve Performance Data
The agent fetches specific analytics reports for any connected social media channel.

## Use Cases

### Quarterly Campaign Audit
The Marketing Lead needs to know which platform is underperforming. They ask their agent: 'What are the analytics for Twitter and LinkedIn?' The agent runs `list_analytics` on both channels, giving the lead a side-by-side comparison of reach metrics instantly.

### Urgent Content Push
A product announcement drops. The Social Media Manager needs to post 3 assets across Instagram and X by noon. They tell their agent, which uses `start_media_upload` for the photos, then runs `create_draft`, and finally executes `create_schedule` on both platforms.

### Content Cleanup
A team member realizes they scheduled an old post that needs to be pulled immediately. They simply tell their agent which post it is, and the agent runs `delete_schedule`, preventing any unnecessary publication errors.

### New Team Setup
The Ops Engineer joins the team and needs to know what's live. They ask the agent: 'What posts are scheduled for this week?' The agent runs `list_schedules` and provides a full, chronological readout of all upcoming content.

## Benefits

- Automate the whole workflow. Instead of manually logging in to Planly to create a schedule, you just tell your agent to 'Schedule X post for Y date.' The `create_schedule` tool handles everything.
- Stop switching apps. You can list all connected channels using `list_channels` and immediately check analytics with `list_analytics`, without ever leaving your AI client window.
- Manage content assets in a single flow. Use `start_media_upload` followed by `finish_media_upload` to handle images and videos, making sure the media is ready before you run `create_schedule`.
- Keep track of everything. If you need to audit your calendar, `list_schedules` gives you every single scheduled post across all platforms at once. You don't have to check them one by one.
- Draft content on the fly. Use `ai_generate_content` or `create_draft` to quickly generate text based on a topic, then use that draft immediately in your next scheduling command.

## How It Works

The bottom line is you manage complex, multi-step social media workflows without ever leaving your AI client.

1. First, subscribe to the Planly server and input your API Key (Bearer Token) from your Planly security settings.
2. Next, tell your AI agent what you need. For example: 'List all connected channels' or 'Schedule a LinkedIn post for tomorrow.'
3. The agent runs the necessary tools—like `list_channels` then `create_schedule`—and provides the result directly in your chat.

## Frequently Asked Questions

**How do I check if my social media channels are connected using Planly MCP Server?**
You run the `list_channels` tool. This immediately tells you exactly which platforms (Instagram, TikTok, etc.) your agent can interact with and publish to.

**Can I list all my scheduled posts for this month using Planly MCP Server?**
Yes. The `list_schedules` tool gives you a full overview of every post planned across all connected platforms, letting you see the whole calendar at once.

**What if I need to change a scheduled post? Do I use Planly MCP Server?**
You first check the details with `get_schedule` to verify the content. If it's wrong, you run `delete_schedule` and then re-create the corrected version using `create_schedule`.

**Does Planly MCP Server handle media uploads?**
Yes. You start the process with `start_media_upload`, upload your files, and finalize them using `finish_media_upload`. The system treats these assets like any other tool input.

**Can I get analytics data from Planly MCP Server?**
You run the `list_analytics` tool. Just specify which channel you want performance metrics for, and your agent pulls the relevant report.

**How do I manage team structures using the `list_teams` tool in Planly MCP Server?**
You can list all connected teams by calling `list_teams`. This function retrieves metadata for every organizational unit linked to your account. You use this data to ensure your AI client targets content correctly when scheduling posts for specific groups.

**Can I batch schedule multiple posts using the `create_schedule` tool in Planly MCP Server?**
Yes, you can process schedules in bulk. The `create_schedule` tool accepts parameters to define content and timing for several channels simultaneously. This lets your AI client build out a week's worth of cross-platform posts quickly.

**What is the purpose of using the `ai_generate_content` tool with Planly MCP Server?**
The `ai_generate_content` tool writes suggested copy based on your prompt. It generates drafts that you then pass to other tools, like `create_schedule`, for final publishing. This handles the creative input phase of your workflow.

**Can my AI automatically find the scheduled posts for the next 7 days?**
Yes! Use the `list_schedules` tool. Your agent will respond with complete metadata for all upcoming posts, including channel names, scheduled times, and content previews in seconds.

**How do I find my Planly API Key?**
Log in to your Planly account, navigate to **Settings** > **Security**, and you will find your unique secret API key (Bearer Token) there.

**Can I use the AI to generate captions?**
Absolutely. Use the `ai_complete` tool. Provide your prompt or post idea, and the agent will utilize Planly's integrated AI to return professional copy options.