@posteverywhere/mcp
OfficialThis MCP server lets an AI agent schedule, publish, and manage social media posts across 13 platforms via PostEverywhere — plus media, AI content generation, analytics, campaigns, and webhooks.
Accounts —
list_accounts,get_account,get_account_healthto see connected platforms, token expiry, and whether an account can post (detect dead tokens before publishing).Posts —
create_post(publish now, schedule, or save as a human-review draft),schedule_postto approve/publish drafts,update_post,delete_post,list_posts/list_posts_advanced(filter by status, platform, account, campaign, date ranges, content search, sort/paginate).Publishing results —
get_post_resultsfor per-destination URLs and errors,retry_failed_postandretry_failed_posts(filter by account, platform, date range, or explicit post IDs) to re-queue failures.Bulk operations —
bulk_create_poststo create up to 50 posts in one rate-limit hit with per-item success/error reporting.Media —
list_media,get_media,delete_media, andupload_media_from_urlto import a public image URL straight into the library for attaching to posts.AI —
generate_image(4 models, 7 aspect ratios) andgenerate_caption(1–5 variants with tone, platform, length, hashtag/emoji controls) to compose posts end-to-end.Analytics & context —
get_meto self-discover org, scopes, plan, and quotas;get_analytics_summaryfor counts, per-platform breakdown, and engagement metrics over a time window.Campaigns — full CRUD (
list_campaigns,create_campaign,get_campaign,update_campaign,delete_campaign) for grouping related posts.Webhooks — full CRUD plus
test_webhookto subscribe to events (post.published, post.failed, account.reconnect_needed, media.*) with HMAC-SHA256 signing.13 platforms — Instagram, TikTok, YouTube, LinkedIn, Facebook, X, Threads, Pinterest, Bluesky, Telegram, Discord, WordPress, and Google Business Profile.
Allows scheduling and publishing posts to Facebook pages, including video, reels, and multi-image posts.
Allows scheduling and publishing posts to Instagram, including feed, reels, stories, and carousels.
Allows scheduling and publishing pins to Pinterest boards.
Allows scheduling and publishing text and media posts to Threads.
Allows scheduling and publishing videos and photo carousels to TikTok.
Allows scheduling and publishing videos with thumbnails, descriptions, and tags to YouTube.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@posteverywhere/mcp Schedule a tweet for tomorrow at 10 AM promoting our new blog post."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@posteverywhere/mcp — Social Media MCP Server for Claude, ChatGPT, Cursor, Codex & AI Agents
mcp-name: io.github.posteverywhere/mcp
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/sdkNode.js SDK instead — full TypeScript types, retry handling, error classes.
🔗 Quick Links
Resource | URL |
🌐 Homepage | |
🛠️ Developers landing page | |
📖 API Documentation | |
📦 This MCP on npm | |
💻 This MCP on GitHub | |
📦 Node SDK (npm) | |
💻 Node SDK (GitHub) | |
⌨️ CLI & Agent Skill (npm) | |
⌨️ CLI & Agent Skill (GitHub) | |
🎛️ Dashboard | |
🔑 Get an API key | |
💵 Pricing | |
📚 Help Center | |
🧠 Model Context Protocol | |
🐛 Issues / bug reports | |
📧 Support |
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/mcpThen 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/mcpClaude 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.
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"
}
}
}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 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 — passscheduled_for, orpublish_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.
Media
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 amedia_idready forcreate_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 |
| ✅ | Your API key from Settings → Developers. Format: |
| ❌ | Override base URL (default |
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.
How it compares
This MCP server | 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
📖 Full API Reference — every tool, every parameter
⚠️ Error Handling — including the
retryableflag agents should respect⏱️ Rate Limits — per-minute, per-hour, per-day caps
🖼️ Media Requirements — file size, format, aspect ratio per platform
🤖 Agent System Prompts — recommended prompts for AI agent integrations
🧠 About MCP — the open protocol behind this server
🚀 Quick Start Guide — first post in 60 seconds
🔗 Webhooks — receive publish events on your endpoints
🏷️ API Scopes — fine-grained permission control
📋 Changelog — what's new in the API
MCP & AI Tooling Resources
PostEverywhere Around the Web
🛠️ Developers Landing Page — overview of API, SDK, MCP, integrations
🤖 AI Agents Page — using PostEverywhere with Claude, ChatGPT, Cursor, and more
💵 Pricing — Lite $9 (2 accounts), Starter $19 (5), Growth $29 (10), Scale $39 (20); API and MCP on every plan; 7-day free trial
✍️ Blog — guides, tutorials, product updates
📚 Help Center — guides, troubleshooting, FAQs
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
Related
📦
@posteverywhere/sdk— Node.js / TypeScript SDK (npm)🌐 posteverywhere.ai — Web dashboard, AI Studio, calendar UI
📚 Help Center — Guides, troubleshooting, FAQ
💵 Pricing — From $9/mo, 7-day free trial
Support
📧 Email: support@posteverywhere.ai
🐛 Issues: github.com/posteverywhere/mcp/issues
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 toolsbulk_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
Scored across 33 tools
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.
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.
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.
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
Related MCP Connectors
Schedule social media posts to Instagram, LinkedIn, X, TikTok and Facebook from your AI assistant.
Schedule, draft and publish social media posts on 18 platforms from your AI assistant.
Draft, schedule and publish social media posts from your AI assistant.
Schedule and publish social posts from your AI to Facebook, Instagram, TikTok and more.
Related MCP Servers
AlicenseAqualityBmaintenanceEnables AI assistants to manage social media publishing across platforms like LinkedIn, Twitter, Facebook, Instagram, Threads, and Bluesky.754 npmMIT
AdaptlyPostofficial
AlicenseAqualityBmaintenanceGives 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.82MIT- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to draft, schedule, and publish social media content, generate AI text and image variations, analyze performance, and automate social workflows.MIT
- AlicenseAqualityCmaintenanceEnables 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.14MIT