@posteverywhere/mcp — Social Media MCP Server for Claude, ChatGPT, Cursor, Codex & AI Agents
Official Model Context Protocol server for PostEverywhere — let Claude Code, Claude Desktop, ChatGPT (via the hosted connector), Cursor, OpenAI Codex, and other MCP-compatible AI clients schedule and publish social media posts to Instagram, TikTok, YouTube, LinkedIn, Facebook, X (Twitter), Threads, and Pinterest using natural language.
💡 Building a programmatic integration? Use the companion @posteverywhere/sdk Node.js SDK instead — full TypeScript types, retry handling, error classes.
🔗 Quick Links
What is MCP?
Model Context Protocol (MCP) is an open standard from Anthropic that lets AI assistants connect to external tools and data sources. Once you connect this MCP server, your AI assistant can:
- Schedule posts across all your connected social accounts
- Generate AI images and attach them to posts
- List, edit, retry, and delete scheduled or published posts
- Surface per-platform publishing results including failure reasons
…all from natural-language prompts inside Claude, Cursor, or any MCP-compatible client.
Quick Start
1. Get an API key
Sign up free at posteverywhere.ai/signup (7-day trial), connect your social accounts, then create an API key at Settings → Developers. Choose your scopes:
- Read — list accounts, posts, and media
- Write — create, edit, delete posts and media
- AI — generate images using AI models
2. Add the MCP server to your AI client
Claude Code
claude mcp add posteverywhere -- npx -y @posteverywhere/mcp
Then set POSTEVERYWHERE_API_KEY in your environment, or pass it as an argument:
claude mcp add posteverywhere -e POSTEVERYWHERE_API_KEY=pe_live_your_key_here -- npx -y @posteverywhere/mcp
📖 Claude Code MCP docs →
Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"posteverywhere": {
"command": "npx",
"args": ["-y", "@posteverywhere/mcp"],
"env": {
"POSTEVERYWHERE_API_KEY": "pe_live_your_key_here"
}
}
}
}
Restart Claude Desktop. The PostEverywhere tools will appear in the 🔨 menu.
📖 Claude Desktop MCP docs →
Cursor
In Cursor, open Settings → MCP → Add new MCP server and paste:
{
"posteverywhere": {
"command": "npx",
"args": ["-y", "@posteverywhere/mcp"],
"env": {
"POSTEVERYWHERE_API_KEY": "pe_live_your_key_here"
}
}
}
📖 Cursor MCP docs →
Other MCP clients
This package exposes a standard stdio MCP server. Any MCP-compatible client can connect using the same configuration shape.
3. Try it out
Once connected, ask your AI assistant things like:
"List my connected social accounts"
"Schedule a post to all my accounts for tomorrow at 2pm: Just shipped a new feature 🚀"
"Show me my recent posts and their publishing status"
"Generate an image of a sunset over mountains in 16:9 and post it to Instagram and X"
"Retry the failed destinations on my latest post"
"What are my last 10 posts on TikTok?"
Accounts
list_accounts — list all connected social accounts and their health statusget_account — get details for a specific account (token expiry, can-post status)
Posts
list_posts — list posts filtered by status (scheduled, published, failed, draft) or platform. Drafts include their target accounts + per-platform content so you can review them before publishing.get_post — get full details for a single post including all destinations (for drafts, the saved accounts + per-platform content)create_post — publish now, schedule for later, or save as a draft for human review (draft: true)schedule_post — publish or schedule a draft (the approval step — pass scheduled_for, or publish_now: true)update_post — modify a scheduled or draft post (content, schedule time, accounts)delete_post — delete a scheduled or draft postget_post_results — per-platform publishing results, errors, and live URLsretry_failed_post — retry every failed destination of a post
🧑💼 Human-in-the-loop drafts — let the agent draft posts for you to approve before anything goes live:
- "Draft a LinkedIn post about our launch — don't publish it yet" →
create_post(draft: true)
- "Show me my drafts" →
list_posts(status: "draft") / get_post
- "Looks good — schedule it for Tuesday 9am" →
schedule_post(scheduled_for: …) (or "publish it now" → publish_now: true)
Drafts are saved in your PostEverywhere account and never publish until you schedule them — review them in the app or via the agent.
list_media — list files in your media libraryget_media — get media file details and processing statusupload_media_from_url — import an image from any public URL into the library (one call, returns a media_id ready for create_post)delete_media — remove a media file
AI
generate_image — generate an image from a text prompt (4 models, 7 aspect ratios)
📖 Full tool reference and parameters →
Example Prompts
These all work out of the box once the server is connected:
Scheduling
- "Schedule a Christmas post for December 25th at 9am: Merry Christmas to our amazing community 🎄"
- "Post this to Instagram and TikTok only: Behind-the-scenes of our latest feature drop"
- "Queue up a week of daily morning posts starting Monday at 9am"
Content generation
- "Generate a 9:16 image of a coffee shop at sunrise and schedule it as a TikTok post for tomorrow"
- "Create a square image of abstract green shapes for a LinkedIn carousel"
Monitoring
- "What posts failed in the last week and why?"
- "Show me the publishing results for my last Instagram Reel"
- "Which of my accounts need to be reconnected?"
Recovery
- "Retry the failed LinkedIn destination on post abc-123"
- "Delete all my draft posts older than 30 days"
Each natural-language prompt maps to one or more MCP tool calls — the agent figures out the right sequence.
All eight platforms work on every plan:
- Instagram — feed, reels, stories, carousels
- TikTok — videos, photo carousels
- YouTube — videos with thumbnails, descriptions, tags
- LinkedIn — text, images, video, document carousels
- Facebook — pages, video, reels, multi-image
- X (Twitter) — text, threads, media (tier-aware char limits)
- Threads — text and media posts
- Pinterest — pins to boards
Configuration
| Environment variable | Required | Description |
|---|
POSTEVERYWHERE_API_KEY | ✅ | Your API key from Settings → Developers. Format: pe_live_... |
POSTEVERYWHERE_BASE_URL | ❌ | Override base URL (default https://app.posteverywhere.ai). Useful for self-hosted deployments. |
Rate Limits
| Resource | Per minute | Per hour | Per day |
|---|
| General API calls | 60 | 1,000 | — |
| Posts | 60 | 200 | 1,000 |
| AI generation | — | 60 | — |
Hitting a 429? The MCP server returns a clear rate_limit_exceeded code with retry_after seconds — the agent will know to wait and retry.
📖 Rate limit details →
How it compares
| This MCP server | PostEverywhere SDK | Direct REST API |
|---|
| Use with Claude / Cursor / MCP clients | ✅ Native | ❌ | ❌ |
| Use in Node.js code | ❌ (use SDK) | ✅ | ✅ |
| Natural-language scheduling | ✅ | ❌ | ❌ |
| TypeScript types | ✅ | ✅ | Manual |
| Auto-retry / backoff | ✅ | ✅ | Manual |
| Best for | AI-assisted social media | Programmatic integrations | Any HTTP client / language |
Documentation
PostEverywhere Around the Web
- 🌐 PostEverywhere Homepage
- 🛠️ Developers Landing Page — overview of API, SDK, MCP, integrations
- 🤖 AI Agents Page — using PostEverywhere with Claude, ChatGPT, Cursor, and more
- 💵 Pricing — Starter ($19), Growth ($39), Pro ($79); 7-day free trial
- ✍️ Blog — guides, tutorials, product updates
- 📚 Help Center — guides, troubleshooting, FAQs
- 🎛️ Dashboard (sign in)
- ✨ Sign Up — 7-day free trial
- 🔑 Get an API key
- 📦 Node.js SDK (npm)
- 💻 Node.js SDK (GitHub)
- 📦 MCP Server (npm — this package)
- 💻 MCP Server (GitHub — this repo)
- 🏢 PostEverywhere on GitHub
PostEverywhere is the backend for all of these — every plan includes every platform:
- 📷 Instagram Scheduler — feed posts, reels, stories, carousels
- 🎵 TikTok Scheduler — videos, photo carousels, full content disclosure flags
- 📺 YouTube Scheduler — videos with thumbnails, tags, descriptions, privacy controls
- 💼 LinkedIn Scheduler — personal + Company Page posts, document carousels, video
- 👍 Facebook Scheduler — Pages, Reels, video, multi-image carousels
- 🐦 X (Twitter), Threads, Pinterest — all included on every plan
Support
License
MIT — see LICENSE.
Built by the team at PostEverywhere. The smarter way to schedule social media to Instagram, TikTok, YouTube, LinkedIn, Facebook, X, Threads, and Pinterest — now with native MCP support for AI agents.