Back to Directory/Analytics & BI

ai.posteverywhere/mcp

The agentic social media scheduler. Write, schedule and publish to all top social platforms.

Analytics & BITypeScriptv1.11.0
View on GitHub

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

mcp-name: io.github.posteverywhere/mcp

npm version npm downloads License: MIT GitHub stars Glama quality score

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

ResourceURL
🌐 Homepageposteverywhere.ai
🛠️ Developers landing pageposteverywhere.ai/developers
📖 API Documentationdevelopers.posteverywhere.ai
📦 This MCP on npmnpmjs.com/package/@posteverywhere/mcp
💻 This MCP on GitHubgithub.com/posteverywhere/mcp
📦 Node SDK (npm)npmjs.com/package/@posteverywhere/sdk
💻 Node SDK (GitHub)github.com/posteverywhere/sdk
⌨️ CLI & Agent Skill (npm)npmjs.com/package/@posteverywhere/cli
⌨️ CLI & Agent Skill (GitHub)github.com/posteverywhere/cli
🎛️ Dashboardapp.posteverywhere.ai
🔑 Get an API keyapp.posteverywhere.ai/developers
💵 Pricingposteverywhere.ai/pricing
📚 Help Centerposteverywhere.ai/support
🧠 Model Context Protocolmodelcontextprotocol.io
🐛 Issues / bug reportsgithub.com/posteverywhere/mcp/issues
📧 Supportsupport@posteverywhere.ai

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. 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 post
  • get_post_results — per-platform publishing results, errors, and live URLs
  • retry_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:

  1. "Draft a LinkedIn post about our launch — don't publish it yet" → create_post(draft: true)
  2. "Show me my drafts" → list_posts(status: "draft") / get_post
  3. "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.

Media

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

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 variableRequiredDescription
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

ResourcePer minutePer hourPer day
General API calls601,000—
Posts602001,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 serverPostEverywhere SDKDirect 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 forAI-assisted social mediaProgrammatic integrationsAny 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.

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y @posteverywhere/mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "ai-posteverywhere-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@posteverywhere/mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

@posteverywhere/mcpnpm

Compatible MCP Clients

ai.posteverywhere/mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More

Google Analytics MCP Server: Ask GA4 Questions DirectlyGA4's reporting interface is powerful but slow to use for a quick question. A Google Analytics MCP server lets Claude query your GA4 property directly, so 'how did organic traffic do last week' gets answered in one message instead of a five-click report build.Read articlePostHog MCP Server: Product Analytics for AI AgentsPostHog folded its MCP server into its main monorepo earlier this year, a consolidation move rather than a shutdown. This guide covers what the server actually exposes, how product analytics differs from the observability MCP servers MCPFind already covers, and what to check before connecting an agent to production analytics data.Read articleClickHouse MCP Server Guide for Analytics and OLAPClickHouse ships a first-party MCP server that queries both ClickHouse Cloud and self-hosted instances, read-only by default, with writes gated behind explicit env vars. This guide covers install, auth, tool names, and where it fits next to Snowflake.Read article