# posteverywhere/mcp [Health: Active]

**Category:** 🌐 Social Media  
**Repository:** https://github.com/posteverywhere/mcp  
**GitHub Stars:** 6  
**npm Downloads (last month):** 845  
**Views:** 6  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/posteverywhere-mcp

## Description
Hosted MCP server to schedule and publish across 11 social platforms (Instagram, LinkedIn, TikTok, X, YouTube, Facebook, Threads, Pinterest, Bluesky, Discord, Telegram). 32 tools covering posts, campaigns, bulk operations, media, analytics, webhooks, and AI captions. Connect with one URL, or run locally via npx -y @posteverywhere/mcp.

## Tools
Capabilities this server exposes over MCP:

- **list_accounts** — list all connected social accounts and their health status
- **get_account** — get details for a specific account (token expiry, can-post status)
- **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
- **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
- **generate_image** — generate an image from a text prompt (4 models, 7 aspect ratios)

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

**Requires environment variables:** `POSTEVERYWHERE_API_KEY` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What posteverywhere/mcp MCP server does

posteverywhere/mcp connects an MCP-compatible AI client to PostEverywhere, which manages publishing to connected social accounts. The supported platform list includes Instagram, TikTok, YouTube, LinkedIn, Facebook, X, Threads, Pinterest, Bluesky, Telegram, Discord, WordPress, and Google Business Profile.

The server covers the operational parts of social publishing. An agent can inspect connected accounts, create posts for immediate publication or future delivery, update or remove scheduled content, and retrieve the outcome for each destination. Posts can also be stored as drafts so a person can review them before anything is published.

## How it works

The package runs as a standard stdio MCP server. After an MCP client starts it, the tools communicate with the PostEverywhere service using an API key. The key is created in the PostEverywhere dashboard after social accounts have been connected, and its scopes determine whether the client can read data, change posts and media, or use AI image generation.

Draft approval is a distinct workflow. `create_post` can save content with `draft: true`; `list_posts` and `get_post` expose the saved destinations and platform-specific content for review. `schedule_post` then either assigns a future time or publishes the draft immediately with `publish_now: true`.

## Setup and configuration

Obtain a PostEverywhere API key from the developer settings in the dashboard. Configure it as `POSTEVERYWHERE_API_KEY`, then launch the package with:

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

Claude Code can add the server with `claude mcp add posteverywhere -- npx -y @posteverywhere/mcp`. Claude Desktop and Cursor use the same `npx` command and environment variable in their MCP configuration. Because the package uses standard stdio, other MCP clients can use the same command and environment setting.

The available API scopes are Read for accounts, posts, and media; Write for creating, editing, deleting posts and media; and AI for image generation.

## Tools and capabilities

- Inspect connected account health, token expiry, and posting availability.
- List posts by status or platform and retrieve complete post details.
- Publish immediately, schedule content, or save drafts for approval.
- Edit or delete scheduled and draft posts.
- View per-platform results, errors, and live URLs after publishing.
- Retry failed destinations individually through the post retry workflow.
- List, inspect, import, and remove media files.
- Generate images from text prompts using four models and seven aspect ratios.

## Limitations and notes

The server operates on accounts already connected to PostEverywhere. Publishing behavior and available destinations therefore depend on those account connections and their ability to post. Imported media must come from a public URL, and the resulting media identifier is used when creating a post.

Drafts remain stored in the PostEverywhere account and do not publish until they are scheduled or explicitly sent with the publish-now option. For programmatic TypeScript integrations rather than MCP clients, PostEverywhere provides a separate Node SDK.

_Full upstream README: https://allmcps.com/mcp/posteverywhere-mcp/readme_

