# helbertparanhos/postforme-mcp-pro [Health: Active]

**Category:** 🌐 Social Media  
**Repository:** https://github.com/helbertparanhos/postforme-mcp-pro  
**GitHub Stars:** 1  
**npm Downloads (last month):** 130  
**Views:** 4  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/helbertparanhos-postforme-mcp-pro

## Description
Post for Me MCP server with 27 typed tools to publish, schedule, edit, delete and analyze social posts across 9 platforms (Instagram, Facebook, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Threads), plus a postformeraw escape hatch and a readonly safety mode.

## Tools
Capabilities this server exposes over MCP:

- **list_social_accounts** — List connected accounts (filter by platform/username).
- **get_social_account** — Get one account by id.
- **create_social_account** — Connect an account by supplying credentials.
- **update_social_account** — Update stored credentials/metadata.
- **create_auth_url** — Start the OAuth connect flow (returns a URL).
- **disconnect_social_account** — Revoke access for an account.
- **list_account_feeds** — Analytics:** recent feed + engagement metrics for an account.
- **create_post** — Create a post (publish now, schedule, or draft) across accounts.
- **publish_now** — Shortcut: publish immediately.
- **schedule_post** — Shortcut: schedule for an ISO-8601 time.
- **create_draft** — Shortcut: save as draft.
- **get_post** — Get a post by id.
- **list_posts** — List posts (filter by status).
- **update_post** — Edit caption/media/accounts/schedule/config.
- **reschedule_post** — Shortcut: change a scheduled time.
- **delete_post** — Delete a post.
- **list_post_results** — Analytics:** per-platform publish outcomes.
- **get_post_result** — One post result by id.
- **create_post_preview** — Preview how a post renders per platform.
- **create_media_upload_url** — Get a signed upload URL (2-step flow).
- **upload_media** — One-step:** upload a local file or remote URL → returns `media_url`.
- **postforme_raw** — Call any `/v1/...` endpoint directly (method, path, params, body).

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

```json
"mcpServers": {
  "postforme-mcp-pro": {
    "command": "npx",
    "args": ["-y","postforme-mcp-pro"],
    "env": {
      "POSTFORME_API_KEY": ""
    }
  }
}
```

**Requires environment variables:** `POSTFORME_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 helbertparanhos/postforme-mcp-pro MCP server does

The helbertparanhos/postforme-mcp-pro MCP server connects MCP clients to the Post for Me API. It provides typed operations for nine social platforms: Instagram, Facebook, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, and Threads. The available operations cover account connections, post creation, scheduling, drafts, editing, deletion, media handling, previews, analytics, and webhook management.

Posts can target multiple connected accounts. The server includes direct operations such as `create_post`, `publish_now`, `schedule_post`, and `create_draft`, so an agent can choose between immediate publishing, ISO-8601 scheduling, or saving content without publishing. Account tools can list and retrieve connected accounts, start an OAuth connection flow, update account details, and disconnect accounts.

## How it works

The server makes authenticated requests to the Post for Me API using a bearer API key. Most API operations are represented by individual MCP tools with typed inputs. The `upload_media` shortcut accepts a local file path or remote URL, performs the upload flow, and returns a `media_url` that can be attached to a post. For clients that need the explicit two-step process, `create_media_upload_url` returns a signed upload URL.

Post previews can show how content renders for different platforms before publication. After publishing, `list_post_results` and `get_post_result` expose per-platform outcomes, while `list_account_feeds` provides recent feed and engagement data for an account. The `postforme_raw` tool can call a `/v1/...` endpoint with a method, path, parameters, and body, extending coverage to endpoints that do not have dedicated tools.

## Setup and configuration

The package can be run from npm with `npx -y postforme-mcp-pro`, or built locally after installing dependencies with npm and running the project build. The required `POSTFORME_API_KEY` identifies the Post for Me account. `POSTFORME_BASE_URL` can override the default `https://api.postforme.dev` endpoint.

Optional settings include `POSTFORME_READONLY=true`, which blocks write tools and allows read operations plus GET use of `postforme_raw`. `POSTFORME_DISABLE_RAW=true` removes the raw endpoint tool. `POSTFORME_TIMEOUT_MS` controls the request timeout, and `POSTFORME_MAX_RETRIES` controls retries for rate limits, server errors, and network failures. The documented defaults are 60,000 milliseconds and three retries.

The README provides local configurations for Claude Desktop and Cursor. Both invoke the built server with Node.js and pass `POSTFORME_API_KEY` through the process environment.

## Tools and capabilities

- Manage social accounts and OAuth connection URLs.
- Publish immediately, schedule posts, create drafts, reschedule, edit, and delete.
- Preview platform-specific rendering and inspect publish results.
- Upload local files or remote media URLs.
- Read account feeds and engagement metrics.
- Create, list, update, retrieve, and delete webhooks.
- Use `postforme_raw` for direct `/v1/...` API requests.

The server also models platform-specific configuration options, including examples such as Instagram Reels, X polls, TikTok privacy, and YouTube visibility.

## Limitations and notes

A Post for Me API key is required. The server's social actions depend on connected accounts and the capabilities of the Post for Me API. Readonly mode is useful for analytics or inspection sessions, but it prevents publishing and other write operations. The raw tool can be disabled independently. Media uploads use remote-fetch protections described by the project, including public-unicast IP validation, no redirects, and a size limit.

_Full upstream README: https://allmcps.com/mcp/helbertparanhos-postforme-mcp-pro/readme_