Skip to main content
Glama
@posteverywhere/mcp

@posteverywhere/mcp

Official

@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 posts to 13 platforms: Instagram, TikTok, YouTube, LinkedIn, Facebook, X (Twitter), Threads, Pinterest, Bluesky, Telegram, Discord, WordPress and Google Business Profile using natural language.

💡 Building a programmatic integration? Use the companion @posteverywhere/sdk Node.js SDK instead — full TypeScript types, retry handling, error classes.

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

🎛️ 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

support@posteverywhere.ai

Related MCP server: AdaptlyPost

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 at posteverywhere.ai/signup (7-day free trial, card required), 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 13 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

  • Bluesky — text and media posts

  • Telegram — posts to channels and groups

  • Discord — posts to server channels

  • WordPress — blog posts (self-hosted and WordPress.com)

  • Google Business Profile — updates, events and offers on your Google Search and Maps listing (one photo, optional button)

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, Bluesky, Telegram, Discord and WordPress, 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, Pinterest, Bluesky, Telegram, Discord and WordPress, now with native MCP support for AI agents.

Available Tools

33 tools
bulk_create_postsAInspect

Create up to 50 posts in one PostEverywhere API call (counts as ONE API-rate-limit hit instead of 50). Each post goes through the same validation as create_post. Returns per-item success/error so you can handle partial failures. Use this for bulk scheduling workflows.

Inputs: posts (required).

create_campaignBInspect

Create a new campaign on PostEverywhere for grouping related posts. Returns the campaign id, which can then be passed as campaign_id when creating posts via create_post.

Inputs: name (required), description, color, status.

create_postAInspect

Create a social media post on PostEverywhere. Three modes: (1) PUBLISH NOW — give content + account_ids, omit scheduled_for; (2) SCHEDULE — add scheduled_for; (3) DRAFT for human review — set draft: true, which saves the post WITHOUT publishing it (it appears in the user's PostEverywhere app and via list_posts(status:"draft"); you then publish it with schedule_post once approved). Use draft mode whenever a human wants to check posts before they go live. Supports per-platform overrides and media. Returns the post ID, its status, and the next step to take.

Inputs: content (required), account_ids, scheduled_for, timezone, +2 more.

create_webhookAInspect

Create a webhook subscription on PostEverywhere. PostEverywhere will POST event payloads to the URL whenever a subscribed event occurs (post.published, post.failed, account.reconnect_needed, etc). Each request is signed with HMAC-SHA256 via the X-PostEverywhere-Signature header — verify it against the returned secret. The secret is shown ONLY ONCE in this response. Available events: post.scheduled, post.publishing, post.published, post.failed, post.partially_failed, post.updated, post.deleted, account.connected, account.disconnected, account.reconnect_needed, media.uploaded, media.deleted.

Inputs: url (required), events (required), name, description.

delete_campaignAInspect

Delete a campaign on PostEverywhere. Posts in the campaign survive — their campaign_id is set to NULL.

Inputs: id (required).

delete_mediaAInspect

Delete a media file from the PostEverywhere media library. This permanently removes the file from storage and cannot be undone. Any posts that reference this media will no longer have the attachment. Use with caution.

Inputs: media_id (required).

delete_postAInspect

Delete a scheduled or draft post from PostEverywhere. This permanently removes the post and all its platform destinations. Cannot delete posts that have already been published. Use with caution as this action cannot be undone.

Inputs: post_id (required).

delete_webhookBInspect

Delete a webhook subscription on PostEverywhere. Cascades to delete the delivery history.

Inputs: id (required).

generate_captionAInspect

Generate 1-5 AI caption variants for a social media post on PostEverywhere. Provide a topic and optionally tone, platform, length, hashtag/emoji preferences. Captions respect per-platform character limits (X: 280, Bluesky: 300, LinkedIn: 3000, IG: 2200, FB: 5000, etc) and follow platform conventions. Costs 1 AI credit per caption returned. Companion to generate_image — together they let you compose a complete post in two calls.

Inputs: topic (required), platform, tone, length, +3 more.

generate_imageAInspect

Generate an AI image from a text prompt on PostEverywhere. The image is saved to your media library and can be attached to posts via media_ids. Choose from 4 models: gemini-3-pro (default, balanced quality, 5 credits), nano-banana-pro (photorealism, 15 credits), ideogram-v2 (best for text-in-image, 8 credits), flux-schnell (fastest, 1 credit). Requires the "ai" scope on your API key.

Inputs: prompt (required), aspect_ratio, model.

get_accountAInspect

Get detailed information about a specific connected social media account on PostEverywhere. Returns the account platform, username, health status, and whether it can currently post. Use this to check the status of a single account by its ID.

Inputs: account_id (required).

get_account_healthAInspect

Check the health of a connected social account on PostEverywhere. Returns status (healthy|warning|broken), can_post boolean, token expiry, needs_reconnection flag, recent failure count, last successful publish. Use this before publishing to detect a dead token BEFORE it causes a failed post.

Inputs: id (required).

get_analytics_summaryAInspect

Get aggregate posting metrics over a time window on PostEverywhere. Returns counts (scheduled/published/failed), per-platform breakdown, total views/likes/comments/shares/impressions/clicks across all published posts, and AI credit usage. One call answers "how many posts have I published this week?" without listing every post.

Inputs: period, from, to.

get_campaignAInspect

Get details of a single campaign on PostEverywhere by its id, including post_count.

Inputs: id (required).

get_meAInspect

Get the current API key context on PostEverywhere — who you are, what scopes your key has, what plan the organization is on, and what's remaining on each quota (accounts/AI credits/storage). Use this as the FIRST CALL when initializing an MCP session to self-discover the organization_id, scopes, and quota state.

Inputs: no named parameters.

get_mediaAInspect

Get detailed information about a specific media file on PostEverywhere, including its type, dimensions, file size, upload status, and aspect ratio. Use this to check if an uploaded media file has finished processing before attaching it to a post.

Inputs: media_id (required).

get_postAInspect

Get detailed information about a specific post on PostEverywhere, including its content, media attachments, schedule, and the publishing status on each destination platform. Use this to check if a post was published successfully or to see error details for failed destinations.

Inputs: post_id (required).

get_post_resultsAInspect

Get the per-platform publishing results for a specific post on PostEverywhere. Returns detailed status for each destination including published URLs, error messages, attempt counts, and retry schedules. Use this to check which platforms succeeded or failed after publishing.

Inputs: post_id (required).

get_webhookAInspect

Get details of a single webhook subscription on PostEverywhere (does NOT include the signing secret).

Inputs: id (required).

list_accountsAInspect

List all connected social media accounts on PostEverywhere. Returns account IDs, platform names, usernames, and health status (whether each account can currently post). Use this to see which platforms are available before creating a post.

Inputs: no named parameters.

list_campaignsAInspect

List campaigns in the current workspace on PostEverywhere. Campaigns group related posts (e.g., "Q3 Launch", "Holiday 2026") and can be referenced via campaign_id when creating or filtering posts. Returns id, name, color, status, post_count for each.

Inputs: status, limit, offset.

list_mediaAInspect

List media files in the PostEverywhere media library. Supports filtering by type (image, video, document) and pagination. Returns file metadata including URLs, dimensions, and upload status. Use this to find existing media to attach to posts.

Inputs: type, limit.

list_postsAInspect

List scheduled, published, or draft posts on PostEverywhere. Supports filtering by status (scheduled, published, draft) and platform. Returns post content, scheduling info, and per-platform destination statuses. Use this to check what posts are queued or to review published content.

Inputs: status, platform, limit.

list_posts_advancedAInspect

List posts on PostEverywhere with the FULL set of filters available on the API (since June 2026). Like list_posts but accepts comma-separated multi-status (e.g. "failed,partially_failed"), comma-separated platforms, date ranges (created/scheduled/published/updated), account_id and campaign_id filters, content search, and sort options. Use this for any non-trivial query — e.g. "all failed TikTok posts from last week" — that the basic list_posts can't express.

Inputs: status, platform, account_id, campaign_id, +12 more.

list_webhooksAInspect

List all webhook subscriptions on PostEverywhere for the current organization. Returns id, url, subscribed events, is_active, recent delivery stats. Note: the signing secret is NEVER included in list responses.

Inputs: no named parameters.

retry_failed_postAInspect

Retry all failed platform destinations for a specific post on PostEverywhere. Resets failed destinations back to queued status so they will be re-attempted by the publishing system. Use this when a post failed due to temporary issues like rate limits or token expiry (after the token has been refreshed).

Inputs: post_id (required).

retry_failed_postsAInspect

Retry all failed destinations on PostEverywhere that match a filter (account_id, platform, date range, or explicit post_ids). Saves you from making one retry call per failed post. Requires at least one filter — refuses to retry the entire failure history.

Inputs: post_ids, account_id, platform, failed_after, +2 more.

schedule_postAInspect

Publish or schedule a DRAFT (created with create_post(draft: true)). Pass scheduled_for to schedule it for a future time, or publish_now: true to publish it right away. Optionally pass account_ids to set/override which accounts it posts to (defaults to the accounts saved on the draft). This is the final step of the review workflow: create_post(draft:true) → review with list_posts(status:"draft")/get_post → schedule_post. Only works on drafts — to re-time an already-scheduled post, use update_post.

Inputs: post_id (required), scheduled_for, publish_now, account_ids, +1 more.

test_webhookAInspect

Send a synthetic test ping to a webhook URL on PostEverywhere so you can verify your endpoint receives the request and validates the HMAC signature. Returns the receiver's HTTP status + duration.

Inputs: id (required).

update_campaignBInspect

Update a campaign on PostEverywhere (name, description, color, or active/archived status).

Inputs: id (required), name, description, color, +1 more.

update_postAInspect

Update a scheduled or draft post on PostEverywhere. You can change the content, schedule time, timezone, target accounts, or media attachments. Only posts with status "scheduled" or "draft" can be edited — published posts cannot be modified. Returns the updated post with all its details.

Inputs: post_id (required), content, scheduled_for, timezone, +2 more.

update_webhookBInspect

Update a webhook subscription on PostEverywhere — change url/events/name/description/is_active. Setting is_active=true on an auto-disabled webhook clears the consecutive_failures counter.

Inputs: id (required), url, events, name, +2 more.

upload_media_from_urlAInspect

Import an image from a public URL into the PostEverywhere media library. The image is fetched server-side, stored, and immediately ready to attach to posts via media_ids. Supported: JPEG, PNG, GIF, WebP, HEIC, HEIF — up to 25 MB. Image-only for now; videos still require the 3-step REST flow (POST /v1/media/upload → PUT presigned URL → POST /v1/media/{id}/complete). Returns { media_id, url, content_type, size } — pass media_id directly to create_post.

Inputs: url (required), filename.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 33 tools

    Disambiguation5/5

    Every tool has a clearly distinct purpose, with detailed descriptions that eliminate ambiguity. Tools like list_posts and list_posts_advanced are differentiated by their filtering capabilities, and generate_caption vs generate_image target different modalities. No two tools could be easily confused.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (e.g., create_post, delete_campaign, get_account_health). Even multi-word names like retry_failed_posts and upload_media_from_url adhere to this pattern. The naming is predictable and easy to understand.

    Tool Count4/5

    33 tools is on the higher side for an MCP server, but the domain (social media management with posts, campaigns, media, webhooks, analytics, AI features) justifies the count. Each tool serves a specific function without redundancy. A slight reduction could be possible but the current count is still reasonable.

    Completeness5/5

    The tool surface covers all major operations for the domain: full CRUD for posts, campaigns, webhooks, and media; plus health checks, analytics, AI generation, bulk operations, and workflow support (draft/review/schedule). There are no obvious gaps; everything needed to manage a social media workflow is present.

    Maintenance

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      Enables AI assistants to manage social media publishing across platforms like LinkedIn, Twitter, Facebook, Instagram, Threads, and Bluesky.
      7
      54 npm
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Gives AI agents the ability to schedule and publish social media posts to Instagram, TikTok, YouTube, X, LinkedIn, Facebook, Pinterest, Threads, and Bluesky. Create, schedule, and bulk-plan posts with per-platform captions, then check per-platform results and retry failures.
      82
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants and autonomous agents to connect to social media accounts and manage, generate, schedule, upload media for, and publish content across Facebook Pages, YouTube, TikTok, Instagram, and X, plus maintain a content pipeline.
      14
      MIT