Submit

MCP server for PostEverywhere — let Claude Code, Claude Desktop, Cursor & other MCP clients schedule social media posts to Instagram, X, TikTok, LinkedIn, YouTube, Facebook, Threads

@posteverywhere/mcp — Social Media MCP Server for Claude, Cursor & AI Agents

npm versionnpm downloadsLicense: MITGitHub stars

Official Model Context Protocol server for PostEverywhere — let Claude Code, Claude Desktop, Cursor, 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 Node.js SDK instead — full TypeScript types, retry handling, error classes.

🔗 Quick Links

Resource URL
🌐 Homepage posteverywhere.ai
🛠️ Developers landing page posteverywhere.ai/developers
📖 API Documentation developers.posteverywhere.ai
📦 This MCP on npm npmjs.com/package/@posteverywhere/mcp
💻 This MCP on GitHub github.com/posteverywhere/mcp
📦 Node SDK (npm) npmjs.com/package/posteverywhere
💻 Node SDK (GitHub) github.com/posteverywhere/sdk
🎛️ Dashboard app.posteverywhere.ai
🔑 Get an API key app.posteverywhere.ai/developers
💵 Pricing posteverywhere.ai/pricing
📚 Help Center posteverywhere.ai/support
🧠 Model Context Protocol modelcontextprotocol.io
🐛 Issues / bug reports github.com/posteverywhere/mcp/issues
📧 Support [email protected]

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?"

Available Tools

Accounts

  • list_accounts — list all connected social accounts and their health status
  • get_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
  • get_post — get full details for a single post including all destinations
  • create_post — create and schedule a post to one, several, or all connected accounts
  • update_post — modify a scheduled or draft post (content, schedule time, accounts)
  • delete_post — delete a scheduled or draft post
  • get_post_results — per-platform publishing results, errors, and live URLs
  • retry_failed_post — retry every failed destination of a post

Media

  • list_media — list files in your media library
  • get_media — get media file details and processing status
  • 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.

Supported Platforms

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

MCP & AI Tooling Resources

PostEverywhere Around the Web

Per-Platform Schedulers

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

Related

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.

MCP Server · Populars

MCP Server · New