Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 5 additions & 0 deletions .cursor-plugin/marketplace.json
Original file line number Diff line number Diff line change
Expand Up @@ -477,6 +477,11 @@
"name": "trello",
"source": "third_party/trello",
"description": "Manage your Trello workspace from chat: browse and create boards, view and move lists, create, update, move, archive, and complete cards with labels and due dates, manage checklists, capture Inbox cards, schedule Planner focus time, and search across boards."
},
{
"name": "buffer",
"source": "third_party/buffer",
"description": "Manage social media with Buffer: draft, schedule, and publish posts across connected channels, manage the queue and ideas, and review post performance."
}
]
}
36 changes: 36 additions & 0 deletions third_party/buffer/.cursor-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,36 @@
{
"name": "buffer",
"displayName": "Buffer",
"version": "1.0.0",
"minClientVersions": {
"cursor": "3.13.0"
},
"description": "Manage social media with Buffer: draft, schedule, and publish posts across connected channels, manage the queue and ideas, and review post performance.",
"author": {
"name": "Cursor",
"email": "plugins@cursor.com"
},
"homepage": "https://developers.buffer.com/guides/integrations/mcp.html",
"repository": "https://github.com/cursor/plugins",
"license": "MIT",
"logo": "assets/logo.png",
"keywords": [
"buffer",
"social media",
"scheduling",
"publishing",
"content calendar",
"queue",
"analytics",
"ideas",
"mcp"
],
"category": "integrations",
"tags": [
"buffer",
"social media",
"scheduling",
"mcp"
],
"mcpServers": "./mcp.json"
}
9 changes: 9 additions & 0 deletions third_party/buffer/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,9 @@
# Changelog

All notable changes to this plugin will be documented here.

## 1.0.0 — initial release

- Added the `buffer` MCP server pointing at Buffer's hosted Streamable HTTP endpoint (`https://mcp.buffer.com/mcp`).
- Auth uses OAuth with Buffer user login (PKCE, dynamic client registration via `auth.buffer.com`) — no API key or client ID to configure. Registration was verified to accept every Cursor redirect set, including Grok Bot mobile.
- Logo: Buffer's official stacked mark, from the icon published on buffer.com, on a 192×192 tile.
21 changes: 21 additions & 0 deletions third_party/buffer/LICENSE
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
MIT License

Copyright (c) 2026 Cursor

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.
68 changes: 68 additions & 0 deletions third_party/buffer/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,68 @@
# Buffer

Cursor plugin that connects agents to [Buffer](https://buffer.com) through Buffer's official remote [Model Context Protocol](https://modelcontextprotocol.io/) server.

Read your connected social channels, browse the queue and drafts, draft, schedule, edit, and publish posts, capture ideas, reuse post templates, and pull post analytics — all from chat.

## Install

1. Open **Cursor Settings → Plugins**.
2. Search for **Buffer**.
3. Click **Install**, then complete the Buffer sign-in prompt.

Or run `/add-plugin buffer` in chat.

## MCP

```json
{
"mcpServers": {
"buffer": {
"type": "http",
"url": "https://mcp.buffer.com/mcp"
}
}
}
```

Auth is OAuth. Cursor prompts for Buffer sign-in when the plugin connects — there is no client ID or API key to configure. Each user signs in with their own Buffer account.

## Before you connect

You need a Buffer account ([sign up](https://buffer.com)) with at least one connected social channel. MCP access is included on every Buffer plan, including Free. Requests count against the same [rate limits](https://developers.buffer.com/guides/api-limits.html) as any other API client, with quotas that depend on your plan; every tool response reports the remaining quota. The connection covers your whole account — every organization and channel in it — so if you belong to more than one organization, the agent will ask which one you mean.

## What agents can do

| Category | Capabilities |
| --- | --- |
| Account | `get_account` returns the signed-in account, its organizations with plan limits and member counts, and the account timezone with its current local time, which the agent uses to turn "tomorrow at 5pm" into a real timestamp |
| Channels | `list_channels` lists the social accounts connected to an organization (service, type, avatar, connection status); `get_channel` adds a channel's posting schedule, posting goals, queue status, timezone, link shortening, and service-specific data such as Pinterest boards |
| Posts | `list_posts` filters by channel, status (`draft`, `needs_approval`, `scheduled`, `sending`, `sent`, `error`), tags, and date ranges, with optional per-post metrics; `get_post` reads one post in full including any publishing error; `create_post` schedules or publishes on one channel with queue, share-now, share-next, or custom-time modes, media, threads, link previews, service metadata, and a save-to-draft option; `edit_post` changes text, media, tags, or scheduling; `delete_post` removes a post permanently |
| Ideas | `list_ideas` and `list_idea_groups` browse the ideas board; `create_idea` saves a concept with title, text, media, tags, target services, and target date without scheduling anything |
| Post templates | `list_post_templates`, `get_post_template`, `create_post_template`, `update_post_template`, and `delete_post_template` manage reusable templates with `{{placeholders}}` at private or internal visibility |
| Analytics | `get_aggregated_post_metrics` totals reactions, comments, and, where every channel supports them, reach, impressions, and engagement rate across posts in a date range of up to 365 days |
| GraphQL | `introspect_schema` returns the full Buffer API schema; `execute_query` runs a read-only query and `execute_mutation` runs a mutation for anything the tools above do not cover |

The server also exposes the schema as a `buffer://schema` resource and a `review_weekly_posts` prompt that groups the week's scheduled posts by channel.

The hosted runtime is the source of truth for tool names and schemas.

## Notes

- **Publishing is live to real social accounts.** `create_post` with `shareNow` publishes immediately, and `automatic` scheduling publishes without a further check; `delete_post` cannot be undone. Confirm the channel, text, and time before letting the agent publish or schedule, and leave Cursor's tool-approval prompts on for write tools.
- `saveToDraft` on `create_post` keeps a post in the queue for review instead of scheduling it, and `schedulingType: notification` sends you a reminder to post manually rather than publishing for you.
- `execute_mutation` can reach any state-changing operation in the Buffer GraphQL API, not only posts.
- Post metrics refresh once a day, so analytics can lag the social network by up to a day.

## Docs

- MCP integration guide: https://developers.buffer.com/guides/integrations/mcp.html
- MCP overview: https://buffer.com/mcp
- API reference: https://developers.buffer.com/
- Server URL: https://mcp.buffer.com/mcp

Logo is Buffer's official mark.

## License

MIT
Binary file added third_party/buffer/assets/logo.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
8 changes: 8 additions & 0 deletions third_party/buffer/mcp.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,8 @@
{
"mcpServers": {
"buffer": {
"type": "http",
"url": "https://mcp.buffer.com/mcp"
}
}
}
Loading