mcp

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

[![npm version](https://img.shields.io/npm/v/@posteverywhere/mcp.svg?style=flat-square)](https://www.npmjs.com/package/@posteverywhere/mcp)
[![npm downloads](https://img.shields.io/npm/dw/@posteverywhere/mcp.svg?style=flat-square)](https://www.npmjs.com/package/@posteverywhere/mcp)
[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg?style=flat-square)](LICENSE)
[![GitHub stars](https://img.shields.io/github/stars/posteverywhere/mcp?style=flat-square)](https://github.com/posteverywhere/mcp)
[![Glama quality score](https://glama.ai/mcp/servers/posteverywhere/mcp/badges/score.svg)](https://glama.ai/mcp/servers/posteverywhere/mcp)

Official [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.

> 💡 **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.

## 🔗 Quick Links

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

## What is MCP?

[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:

- **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](https://claude.ai), [Cursor](https://cursor.sh), or any [MCP-compatible client](https://modelcontextprotocol.io/clients).

## Quick Start

### 1. Get an API key

Sign 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:

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

```bash
claude mcp add posteverywhere -- npx -y @posteverywhere/mcp
```

Then set `POSTEVERYWHERE_API_KEY` in your environment, or pass it as an argument:

```bash
claude mcp add posteverywhere -e POSTEVERYWHERE_API_KEY=pe_live_your_key_here -- npx -y @posteverywhere/mcp
```

📖 [Claude Code MCP docs →](https://docs.claude.com/en/docs/claude-code/mcp)

#### Claude Desktop

Edit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "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 →](https://modelcontextprotocol.io/quickstart/user)

#### Cursor

In Cursor, open **Settings → MCP → Add new MCP server** and paste:

```json
{
  "posteverywhere": {
    "command": "npx",
    "args": ["-y", "@posteverywhere/mcp"],
    "env": {
      "POSTEVERYWHERE_API_KEY": "pe_live_your_key_here"
    }
  }
}
```

📖 [Cursor MCP docs →](https://docs.cursor.com/context/model-context-protocol)

#### Other MCP clients

This package exposes a standard `stdio` MCP server. Any [MCP-compatible client](https://modelcontextprotocol.io/clients) 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 →](https://developers.posteverywhere.ai)

## 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](https://posteverywhere.ai/instagram-scheduler)** — feed, reels, stories, carousels
- **[TikTok](https://posteverywhere.ai/tiktok-scheduler)** — videos, photo carousels
- **[YouTube](https://posteverywhere.ai/youtube-scheduler)** — videos with thumbnails, descriptions, tags
- **[LinkedIn](https://posteverywhere.ai/linkedin-scheduler)** — text, images, video, document carousels
- **[Facebook](https://posteverywhere.ai/facebook-scheduler)** — 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](https://app.posteverywhere.ai/developers). Fo