{
  "markdown": "# @posteverywhere/mcp — Social Media MCP Server for Claude, ChatGPT, Cursor, Codex & AI Agents\n\nmcp-name: io.github.posteverywhere/mcp\n\n[![npm version](https://img.shields.io/npm/v/@posteverywhere/mcp.svg?style=flat-square)](https://www.npmjs.com/package/@posteverywhere/mcp)\n[![npm downloads](https://img.shields.io/npm/dw/@posteverywhere/mcp.svg?style=flat-square)](https://www.npmjs.com/package/@posteverywhere/mcp)\n[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](LICENSE)\n[![GitHub stars](https://img.shields.io/github/stars/posteverywhere/mcp?style=flat-square)](https://github.com/posteverywhere/mcp)\n[![Glama quality score](https://glama.ai/mcp/servers/posteverywhere/mcp/badges/score.svg)](https://glama.ai/mcp/servers/posteverywhere/mcp)\n\nOfficial [Model Context Protocol](https://modelcontextprotocol.io) server for [PostEverywhere](https://posteverywhere.ai) — let [Claude Code](https://docs.claude.com/en/docs/claude-code/overview), [Claude Desktop](https://claude.ai/download), [ChatGPT](https://chatgpt.com) (via the [hosted connector](https://posteverywhere.ai/agents)), [Cursor](https://cursor.sh), [OpenAI Codex](https://openai.com/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.\n\n> 💡 **Building a programmatic integration?** Use the companion [`@posteverywhere/sdk`](https://www.npmjs.com/package/@posteverywhere/sdk) Node.js SDK instead — full TypeScript types, retry handling, error classes.\n\n## 🔗 Quick Links\n\n| Resource | URL |\n|---|---|\n| 🌐 **Homepage** | [posteverywhere.ai](https://posteverywhere.ai) |\n| 🛠️ **Developers landing page** | [posteverywhere.ai/developers](https://posteverywhere.ai/developers) |\n| 📖 **API Documentation** | [developers.posteverywhere.ai](https://developers.posteverywhere.ai) |\n| 📦 **This MCP on npm** | [npmjs.com/package/@posteverywhere/mcp](https://www.npmjs.com/package/@posteverywhere/mcp) |\n| 💻 **This MCP on GitHub** | [github.com/posteverywhere/mcp](https://github.com/posteverywhere/mcp) |\n| 📦 **Node SDK (npm)** | [npmjs.com/package/@posteverywhere/sdk](https://www.npmjs.com/package/@posteverywhere/sdk) |\n| 💻 **Node SDK (GitHub)** | [github.com/posteverywhere/sdk](https://github.com/posteverywhere/sdk) |\n| ⌨️ **CLI & Agent Skill (npm)** | [npmjs.com/package/@posteverywhere/cli](https://www.npmjs.com/package/@posteverywhere/cli) |\n| ⌨️ **CLI & Agent Skill (GitHub)** | [github.com/posteverywhere/cli](https://github.com/posteverywhere/cli) |\n| 🎛️ **Dashboard** | [app.posteverywhere.ai](https://app.posteverywhere.ai) |\n| 🔑 **Get an API key** | [app.posteverywhere.ai/developers](https://app.posteverywhere.ai/developers) |\n| 💵 **Pricing** | [posteverywhere.ai/pricing](https://posteverywhere.ai/pricing) |\n| 📚 **Help Center** | [posteverywhere.ai/support](https://posteverywhere.ai/support) |\n| 🧠 **Model Context Protocol** | [modelcontextprotocol.io](https://modelcontextprotocol.io) |\n| 🐛 **Issues / bug reports** | [github.com/posteverywhere/mcp/issues](https://github.com/posteverywhere/mcp/issues) |\n| 📧 **Support** | [support@posteverywhere.ai](mailto:support@posteverywhere.ai) |\n\n## What is MCP?\n\n[Model Context Protocol (MCP)](https://modelcontextprotocol.io) is an open standard from [Anthropic](https://www.anthropic.com) that lets AI assistants connect to external tools and data sources. Once you connect this MCP server, your AI assistant can:\n\n- **Schedule posts** across all your connected social accounts\n- **Generate AI images** and attach them to posts\n- **List, edit, retry, and delete** scheduled or published posts\n- **Surface per-platform publishing results** including failure reasons\n\n…all from natural-language prompts inside [Claude](https://claude.ai), [Cursor](https://cursor.sh), or any [MCP-compatible client](https://modelcontextprotocol.io/clients).\n\n## Quick Start\n\n### 1. Get an API key\n\nSign up free at [posteverywhere.ai/signup](https://app.posteverywhere.ai/signup) (7-day trial), connect your social accounts, then create an API key at [Settings → Developers](https://app.posteverywhere.ai/developers). Choose your scopes:\n\n- **Read** — list accounts, posts, and media\n- **Write** — create, edit, delete posts and media\n- **AI** — generate images using AI models\n\n### 2. Add the MCP server to your AI client\n\n#### Claude Code\n\n```bash\nclaude mcp add posteverywhere -- npx -y @posteverywhere/mcp\n```\n\nThen set `POSTEVERYWHERE_API_KEY` in your environment, or pass it as an argument:\n\n```bash\nclaude mcp add posteverywhere -e POSTEVERYWHERE_API_KEY=pe_live_your_key_here -- npx -y @posteverywhere/mcp\n```\n\n📖 [Claude Code MCP docs →](https://docs.claude.com/en/docs/claude-code/mcp)\n\n#### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"posteverywhere\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@posteverywhere/mcp\"],\n      \"env\": {\n        \"POSTEVERYWHERE_API_KEY\": \"pe_live_your_key_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. The PostEverywhere tools will appear in the 🔨 menu.\n\n📖 [Claude Desktop MCP docs →](https://modelcontextprotocol.io/quickstart/user)\n\n#### Cursor\n\nIn Cursor, open **Settings → MCP → Add new MCP server** and paste:\n\n```json\n{\n  \"posteverywhere\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"@posteverywhere/mcp\"],\n    \"env\": {\n      \"POSTEVERYWHERE_API_KEY\": \"pe_live_your_key_here\"\n    }\n  }\n}\n```\n\n📖 [Cursor MCP docs →](https://docs.cursor.com/context/model-context-protocol)\n\n#### Other MCP clients\n\nThis package exposes a standard `stdio` MCP server. Any [MCP-compatible client](https://modelcontextprotocol.io/clients) can connect using the same configuration shape.\n\n### 3. Try it out\n\nOnce connected, ask your AI assistant things like:\n\n> \"List my connected social accounts\"\n\n> \"Schedule a post to all my accounts for tomorrow at 2pm: Just shipped a new feature 🚀\"\n\n> \"Show me my recent posts and their publishing status\"\n\n> \"Generate an image of a sunset over mountains in 16:9 and post it to Instagram and X\"\n\n> \"Retry the failed destinations on my latest post\"\n\n> \"What are my last 10 posts on TikTok?\"\n\n## Available Tools\n\n### Accounts\n- `list_accounts` — list all connected social accounts and their health status\n- `get_account` — get details for a specific account (token expiry, can-post status)\n\n### Posts\n- `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.\n- `get_post` — get full details for a single post including all destinations (for drafts, the saved accounts + per-platform content)\n- `create_post` — publish now, schedule for later, **or save as a draft for human review** (`draft: true`)\n- `schedule_post` — publish or schedule a **draft** (the approval step — pass `scheduled_for`, or `publish_now: true`)\n- `update_post` — modify a scheduled or draft post (content, schedule time, accounts)\n- `delete_post` — delete a scheduled or draft post\n- `get_post_results` — per-platform publishing results, errors, and live URLs\n- `retry_failed_post` — retry every failed destination of a post\n\n> **🧑‍💼 Human-in-the-loop drafts** — let the agent draft posts for you to approve before anything goes live:\n> 1. *\"Draft a LinkedIn post about our launch — don't publish it yet\"* → `create_post(draft: true)`\n> 2. *\"Show me my drafts\"* → `list_posts(status: \"draft\")` / `get_post`\n> 3. *\"Looks good — schedule it for Tuesday 9am\"* → `schedule_post(scheduled_for: …)` (or *\"publish it now\"* → `publish_now: true`)\n>\n> Drafts are saved in your PostEverywhere account and **never publish until you schedule them** — review them in the app or via the agent.\n\n### Media\n- `list_media` — list files in your media library\n- `get_media` — get media file details and processing status\n- `upload_media_from_url` — import an image from any public URL into the library (one call, returns a `media_id` ready for `create_post`)\n- `delete_media` — remove a media file\n\n### AI\n- `generate_image` — generate an image from a text prompt (4 models, 7 aspect ratios)\n\n📖 [Full tool reference and parameters →](https://developers.posteverywhere.ai)\n\n## Example Prompts\n\nThese all work out of the box once the server is connected:\n\n### Scheduling\n- *\"Schedule a Christmas post for December 25th at 9am: Merry Christmas to our amazing community 🎄\"*\n- *\"Post this to Instagram and TikTok only: Behind-the-scenes of our latest feature drop\"*\n- *\"Queue up a week of daily morning posts starting Monday at 9am\"*\n\n### Content generation\n- *\"Generate a 9:16 image of a coffee shop at sunrise and schedule it as a TikTok post for tomorrow\"*\n- *\"Create a square image of abstract green shapes for a LinkedIn carousel\"*\n\n### Monitoring\n- *\"What posts failed in the last week and why?\"*\n- *\"Show me the publishing results for my last Instagram Reel\"*\n- *\"Which of my accounts need to be reconnected?\"*\n\n### Recovery\n- *\"Retry the failed LinkedIn destination on post abc-123\"*\n- *\"Delete all my draft posts older than 30 days\"*\n\nEach natural-language prompt maps to one or more MCP tool calls — the agent figures out the right sequence.\n\n## Supported Platforms\n\nAll eight platforms work on every plan:\n\n- **[Instagram](https://posteverywhere.ai/instagram-scheduler)** — feed, reels, stories, carousels\n- **[TikTok](https://posteverywhere.ai/tiktok-scheduler)** — videos, photo carousels\n- **[YouTube](https://posteverywhere.ai/youtube-scheduler)** — videos with thumbnails, descriptions, tags\n- **[LinkedIn](https://posteverywhere.ai/linkedin-scheduler)** — text, images, video, document carousels\n- **[Facebook](https://posteverywhere.ai/facebook-scheduler)** — pages, video, reels, multi-image\n- **X (Twitter)** — text, threads, media (tier-aware char limits)\n- **Threads** — text and media posts\n- **Pinterest** — pins to boards\n\n## Configuration\n\n| Environment variable | Required | Description |\n|---|---|---|\n| `POSTEVERYWHERE_API_KEY` | ✅ | Your API key from [Settings → Developers](https://app.posteverywhere.ai/developers). Format: `pe_live_...` |\n| `POSTEVERYWHERE_BASE_URL` | ❌ | Override base URL (default `https://app.posteverywhere.ai`). Useful for self-hosted deployments. |\n\n## Rate Limits\n\n| Resource | Per minute | Per hour | Per day |\n|---|---|---|---|\n| **General API calls** | 60 | 1,000 | — |\n| **Posts** | 60 | 200 | 1,000 |\n| **AI generation** | — | 60 | — |\n\nHitting a 429? The MCP server returns a clear `rate_limit_exceeded` code with `retry_after` seconds — the agent will know to wait and retry.\n\n📖 [Rate limit details →](https://developers.posteverywhere.ai/rate-limits)\n\n## How it compares\n\n| | This MCP server | [PostEverywhere SDK](https://github.com/posteverywhere/sdk) | Direct REST API |\n|---|---|---|---|\n| Use with Claude / Cursor / MCP clients | ✅ Native | ❌ | ❌ |\n| Use in Node.js code | ❌ (use SDK) | ✅ | ✅ |\n| Natural-language scheduling | ✅ | ❌ | ❌ |\n| TypeScript types | ✅ | ✅ | Manual |\n| Auto-retry / backoff | ✅ | ✅ | Manual |\n| Best for | AI-assisted social media | Programmatic integrations | Any HTTP client / language |\n\n## Documentation\n\n- 📖 [Full API Reference](https://developers.posteverywhere.ai) — every tool, every parameter\n- 🔐 [Authentication & Scopes](https://developers.posteverywhere.ai/authentication)\n- ⚠️ [Error Handling](https://developers.posteverywhere.ai/errors) — including the `retryable` flag agents should respect\n- ⏱️ [Rate Limits](https://developers.posteverywhere.ai/rate-limits) — per-minute, per-hour, per-day caps\n- 🖼️ [Media Requirements](https://developers.posteverywhere.ai/media-requirements) — file size, format, aspect ratio per platform\n- 🤖 [Agent System Prompts](https://developers.posteverywhere.ai/integrations/agent-system-prompt) — recommended prompts for AI agent integrations\n- 🧠 [About MCP](https://modelcontextprotocol.io/introduction) — the open protocol behind this server\n- 🚀 [Quick Start Guide](https://developers.posteverywhere.ai/quick-start) — first post in 60 seconds\n- 🔗 [Webhooks](https://developers.posteverywhere.ai/webhooks) — receive publish events on your endpoints\n- 🏷️ [API Scopes](https://developers.posteverywhere.ai/scopes) — fine-grained permission control\n- 📋 [Changelog](https://developers.posteverywhere.ai/changelog) — what's new in the API\n\n## MCP & AI Tooling Resources\n\n- 🧠 [Model Context Protocol — Specification](https://modelcontextprotocol.io)\n- 🛠️ [MCP Quickstart for Users](https://modelcontextprotocol.io/quickstart/user)\n- 👨‍💻 [MCP Quickstart for Developers](https://modelcontextprotocol.io/quickstart/server)\n- 🗂️ [Browse all MCP servers (community list)](https://modelcontextprotocol.io/examples)\n- 💼 [Anthropic — MCP announcement](https://www.anthropic.com/news/model-context-protocol)\n- 🔧 [Claude Code — Get started](https://docs.claude.com/en/docs/claude-code/overview)\n- 🔧 [Claude Code — MCP setup](https://docs.claude.com/en/docs/claude-code/mcp)\n- 🖥️ [Claude Desktop](https://claude.ai/download)\n- 🖱️ [Cursor — MCP docs](https://docs.cursor.com/context/model-context-protocol)\n- 💬 [Anthropic Claude](https://claude.ai)\n\n## PostEverywhere Around the Web\n\n- 🌐 [PostEverywhere Homepage](https://posteverywhere.ai)\n- 🛠️ [Developers Landing Page](https://posteverywhere.ai/developers) — overview of API, SDK, MCP, integrations\n- 🤖 [AI Agents Page](https://posteverywhere.ai/agents) — using PostEverywhere with Claude, ChatGPT, Cursor, and more\n- 💵 [Pricing](https://posteverywhere.ai/pricing) — Starter ($19), Growth ($39), Pro ($79); 7-day free trial\n- ✍️ [Blog](https://posteverywhere.ai/blog) — guides, tutorials, product updates\n- 📚 [Help Center](https://posteverywhere.ai/support) — guides, troubleshooting, FAQs\n- 🎛️ [Dashboard (sign in)](https://app.posteverywhere.ai)\n- ✨ [Sign Up — 7-day free trial](https://app.posteverywhere.ai/signup)\n- 🔑 [Get an API key](https://app.posteverywhere.ai/developers)\n- 📦 [Node.js SDK (npm)](https://www.npmjs.com/package/@posteverywhere/sdk)\n- 💻 [Node.js SDK (GitHub)](https://github.com/posteverywhere/sdk)\n- 📦 [MCP Server (npm — this package)](https://www.npmjs.com/package/@posteverywhere/mcp)\n- 💻 [MCP Server (GitHub — this repo)](https://github.com/posteverywhere/mcp)\n- 🏢 [PostEverywhere on GitHub](https://github.com/posteverywhere)\n\n## Per-Platform Schedulers\n\nPostEverywhere is the backend for all of these — every plan includes every platform:\n\n- 📷 [Instagram Scheduler](https://posteverywhere.ai/instagram-scheduler) — feed posts, reels, stories, carousels\n- 🎵 [TikTok Scheduler](https://posteverywhere.ai/tiktok-scheduler) — videos, photo carousels, full content disclosure flags\n- 📺 [YouTube Scheduler](https://posteverywhere.ai/youtube-scheduler) — videos with thumbnails, tags, descriptions, privacy controls\n- 💼 [LinkedIn Scheduler](https://posteverywhere.ai/linkedin-scheduler) — personal + Company Page posts, document carousels, video\n- 👍 [Facebook Scheduler](https://posteverywhere.ai/facebook-scheduler) — Pages, Reels, video, multi-image carousels\n- 🐦 X (Twitter), Threads, Pinterest — all included on every plan\n\n## Related\n\n- 📦 **[`@posteverywhere/sdk`](https://github.com/posteverywhere/sdk)** — Node.js / TypeScript SDK ([npm](https://www.npmjs.com/package/@posteverywhere/sdk))\n- 🌐 **[posteverywhere.ai](https://posteverywhere.ai)** — Web dashboard, AI Studio, calendar UI\n- 📚 **[Help Center](https://posteverywhere.ai/support)** — Guides, troubleshooting, FAQ\n- 💵 **[Pricing](https://posteverywhere.ai/pricing)** — From $19/mo, 7-day free trial\n\n## Support\n\n- 📧 Email: [support@posteverywhere.ai](mailto:support@posteverywhere.ai)\n- 🐛 Issues: [github.com/posteverywhere/mcp/issues](https://github.com/posteverywhere/mcp/issues)\n- 💬 [Help Center](https://posteverywhere.ai/support)\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n\n---\n\nBuilt by the team at [PostEverywhere](https://posteverywhere.ai). The smarter way to schedule social media to [Instagram](https://posteverywhere.ai/instagram-scheduler), [TikTok](https://posteverywhere.ai/tiktok-scheduler), [YouTube](https://posteverywhere.ai/youtube-scheduler), [LinkedIn](https://posteverywhere.ai/linkedin-scheduler), [Facebook](https://posteverywhere.ai/facebook-scheduler), X, Threads, and Pinterest — now with native [MCP support](https://modelcontextprotocol.io) for AI agents.\n",
  "bytes": 16528,
  "sha": "8bc090062cf2fd9bde4309c5f205a529cb9926765a89fa0bcb7fea3ee8e433a9",
  "repo_slug": "posteverywhere/mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_ai_posteverywhere_mcp_fee99482/readme"
}