# Buffer MCP

> Buffer MCP connects your AI client directly to Buffer's social media management API. Schedule posts, list connected accounts, and pull real-time analytics across Twitter, LinkedIn, Facebook, and more—all from one command.

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

## Description

Stop bouncing between different social platforms just to manage content. This MCP lets your agent take full control of your entire publishing strategy using natural conversation. You tell it what needs posting, for which channels, and when you want it live. It handles the complex queue management, confirming the timing and ensuring high-fidelity text or media posts go out exactly when planned. Need to know if a post worked? Your agent retrieves detailed analytics on impressions and clicks from past content. This MCP puts all your scheduling, profile management, and performance history into one place via Vinkius, so you never have to manually check multiple dashboards again.

## Tools

### schedule_social_post
Creates and submits a brand new piece of content to the publishing queue on specific platforms.

### remove_social_post
Deletes a social media post that was either scheduled or published.

### modify_pending_post
Makes changes to a post after it's scheduled but before it actually publishes.

### get_api_status
Verifies that the connection between your client and Buffer is active.

### list_pending_posts
Checks the list of posts currently scheduled and waiting to go live.

### get_profile_details
Fetches detailed account information for a connected social media profile.

### get_posting_schedules
Checks the current and future posting times set up for your accounts.

### list_published_posts
Retrieves a historical record of all content that has already been successfully published.

### get_post_details
Retrieves specific information about a single social media post.

### list_social_profiles
Lists every connected social media account that the MCP can manage.

### test_buffer_auth
Runs a test to ensure your authentication credentials are correct and functional.

### modify_posting_schedules
Adjusts the overall posting times and frequency rules for your brand's accounts.

## Prompt Examples

**Prompt:** 
```
List all my connected social media profiles in Buffer.
```

**Response:** 
```
I've retrieved your social profiles. You currently have 3 connected accounts: Twitter (@user1), LinkedIn (ID: abc), and Facebook Page. Which one should we manage or check for scheduled posts?
```

**Prompt:** 
```
Schedule a post: 'Excited to announce our new integration!' for Twitter and LinkedIn profiles.
```

**Response:** 
```
Content scheduled! I've successfully added your update to the queue for both Twitter and LinkedIn. It will be published according to your next available time slot. Shall I check your current posting schedule?
```

**Prompt:** 
```
Show the engagement statistics for my last 5 published posts.
```

**Response:** 
```
Fetching historical performance... Your last 5 posts received a total of 1,240 impressions and 85 clicks. Your post from yesterday was the top performer with a 5% engagement rate. Would you like the detailed metadata for it?
```

## Capabilities

### List all connected social media accounts
Retrieves a list of every single social platform linked to your Buffer profile.

### Schedule and draft new content
Adds updates or posts to the publishing queue across multiple channels at set times.

### Modify existing scheduled posts
Changes a post's text, media, or schedule date after it has been drafted but before it publishes.

### Check content history and queue status
Retrieves records of published updates or monitors posts waiting in the system's draft queue.

### Get real-time performance stats
Pulls current engagement data, showing metrics for specific past content pieces.

## Use Cases

### A campaign needs to go live across three different platforms simultaneously.
The user asks their agent to 'Schedule an announcement for Twitter, LinkedIn, and Facebook at 2 PM.' The agent uses `schedule_social_post` multiple times, confirming the update is added to the queue on all three channels.

### Performance review after a big launch.
The user asks their agent to 'Show me the stats for my last five posts.' The agent uses `list_published_posts` and then fetches engagement data, giving instant ROI feedback without leaving the chat.

### A client needs to pull all connected accounts before starting a project.
The user simply asks 'What profiles do we have?' The agent uses `list_social_profiles` and returns a clear, actionable list of every managed account for the team.

### A post was scheduled incorrectly and needs an emergency change.
The user tells the agent to 'Change the text on my draft LinkedIn post.' The agent calls `modify_pending_post` using the specific content ID, correcting the error before it goes live.

## Benefits

- Stop checking multiple dashboards. Your agent can pull a list of connected accounts using `list_social_profiles` and manage them all through one chat window.
- Avoid publishing errors. Need to change a caption or delay a post? Use `modify_pending_post` to adjust drafts right before they go out.
- Know what's working instantly. By fetching historical data via `list_published_posts`, you get real metrics on performance for your content strategy.
- Keep your brand voice consistent. You can use `modify_posting_schedules` and `get_posting_schedules` to enforce rules about when and how often you post.
- Speed up publishing pipelines. Scheduling a new update is simple: just run `schedule_social_post`, specifying the content and the targets.

## How It Works

The bottom line is, it lets your AI treat Buffer like another native function within your workflow.

1. Subscribe to this MCP and grab your Buffer Access Token from the platform's settings.
2. Connect that token to your preferred AI client (Claude, Cursor, etc.) through Vinkius.
3. Use natural language commands to tell your agent exactly what you want to schedule or analyze.

## Frequently Asked Questions

**How do I check my connected social media profiles using list_social_profiles?**
Running the `list_social_profiles` tool instantly gives you a complete manifest of every account linked to your Buffer. It's the first step before managing anything.

**Can I change content scheduled for next week with modify_pending_post?**
Yes, `modify_pending_post` lets you edit drafts that are already in the queue but haven't gone live. You just need to provide the post ID and the new text.

**What is the difference between list_published_posts and list_pending_posts?**
`list_published_posts` shows what already went out; `list_pending_posts` only shows what's waiting in the queue for its scheduled time.

**Do I need to run get_api_status before scheduling a post?**
It's good practice. Running `get_api_status` first confirms your credentials are active and that the connection is healthy before you commit content to the queue.

**What information does `get_post_details` return about a specific social media update?**
It returns granular details for that single post. You can pull the original content, associated media links, and key performance metrics like impressions and engagement rate directly from the post ID.

**If I want to change my overall posting frequency, what does `modify_posting_schedules` handle?**
This tool lets you adjust your brand's rhythm across platforms. You pass the specific platform and a time array, allowing you to set rules for multiple days or weeks at once.

**When should I use `test_buffer_auth` instead of just checking my connection status?**
Run this tool when you suspect your credentials might be out of date. It verifies the active access token's scope, confirming all necessary API permissions are available for current operations.

**What steps do I take to permanently remove content using `remove_social_post`?**
You must provide the unique post ID and the platform name. This action is irreversible, so verify you want to delete it from the queue before running the command.

**How do I find my Buffer Access Token?**
Log in to your Buffer account, navigate to **Settings** > **Personal Access Tokens**, and generate a new token for your integration.

**Can I post to multiple social profiles at once?**
Yes! The `schedule_social_post` tool accepts a JSON array of profile IDs, allowing you to broadcast the same update across all your connected platforms.

**How do I check my scheduled queue?**
Use the `list_pending_posts` tool with a specific profile ID to retrieve all updates currently waiting to be published.