# PostHero [Health: Active]

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

## Description
PostHero MCP server — schedule and publish social media posts from any MCP-compatible AI tool

## Tools
Capabilities this server exposes over MCP:

- **list_accounts** — List connected social media accounts
- **create_post** — Create, schedule, or publish a post
- **list_posts** — List posts with filters (status, platform)
- **get_post** — Get full details of a post
- **update_post** — Update a draft or scheduled post
- **delete_post** — Delete a post from PostHero
- **publish_post** — Immediately publish a draft/scheduled post
- **get_analytics_summary** — Aggregated analytics for a platform
- **get_top_posts** — Top-performing posts ranked by metric

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

```json
"mcpServers": {
  "posthero": {
    "command": "npx",
    "args": ["-y","@posthero/mcp"],
    "env": {
      "POSTHERO_API_KEY": "",
      "POSTHERO_BASE_URL": ""
    }
  }
}
```

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

## Documentation

## What PostHero MCP server does

The PostHero MCP server exposes PostHero’s social media publishing and analytics functions to AI assistants that support MCP. It is intended for workflows where an assistant needs to work with connected social accounts, prepare content, schedule publication, publish immediately, or inspect results without switching to a separate PostHero interface.

Supported platforms are LinkedIn, Twitter/X, Instagram, Facebook, YouTube, TikTok, Threads, and Bluesky. The available operations cover both content management and reporting, so the same connection can be used to schedule a post and later review its performance.

## How it works

The package runs as an MCP server through the `npx` command. An MCP client starts the process and supplies the `POSTHERO_API_KEY` environment variable. The server then provides tools that the assistant can call for PostHero account, post, publishing, and analytics operations.

The PostHero MCP server does not describe a separate content-generation system. Instead, it gives the connected AI client access to PostHero actions. For example, an assistant can turn a request to schedule a LinkedIn post into a `create_post` call, or use `get_top_posts` to retrieve high-performing content for a platform.

## Setup and configuration

Create a PostHero account at posthero.ai and obtain an API key from **Settings > API**. Add the server to the MCP client’s configuration with `npx -y @posthero/mcp`, then pass the key as `POSTHERO_API_KEY`.

The README provides configuration examples for Claude Desktop, Cursor, and VS Code. Claude Desktop and Cursor use an `mcpServers` entry with the package command and environment variable. VS Code uses a `servers` entry with `type` set to `stdio`. Windsurf and other MCP-compatible clients are also named as supported usage targets, but their individual configuration format is not specified in the provided material.

`POSTHERO_BASE_URL` can optionally override the default API endpoint, which is `https://server.posthero.ai/api/v1`.

## Tools and capabilities

The PostHero MCP server provides these tools:

- `list_accounts` lists connected social media accounts.
- `create_post` creates a post, schedules it, or publishes it.
- `list_posts` returns posts with status and platform filters.
- `get_post` retrieves complete post details.
- `update_post` changes a draft or scheduled post.
- `delete_post` removes a post from PostHero.
- `publish_post` publishes a draft or scheduled post immediately.
- `get_analytics_summary` returns aggregated analytics for a platform.
- `get_top_posts` ranks top-performing posts by a metric.

These tools fit campaign management, editorial scheduling, post maintenance, immediate publishing, and basic performance review workflows.

## Limitations and notes

A PostHero API key is required. The supplied documentation does not specify account permissions, supported media formats, scheduling time zones, rate limits, analytics metric names, or platform-specific restrictions. It also does not document tool parameters beyond the listed purposes, so those details should be checked in the PostHero API or client experience before building an automated workflow.

The server is focused on PostHero-backed social publishing and analytics. It does not claim to provide direct native integrations with the listed social platforms outside PostHero, and the material does not describe features such as comment management, inbox handling, audience management, or advertising controls.

_Full upstream README: https://allmcps.com/mcp/posthero/readme_