helbertparanhos/postforme-mcp-pro

> The most complete **Post for Me** MCP server — publish, schedule, edit, delete and analyze social posts across **9 platforms** from any MCP client.
postforme-mcp-pro wraps the Post for Me API in **27+ fully-typed MCP tools** (one per operation) plus a postforme_raw escape hatch and a readonly safety mode. Unlike the official MCP — which exposes only a doc-search + sandboxed code-execution tool ("code mode") — every operation here is a first-class, directly-callable tool, so the model can post, schedule and pull analytics without writing SDK code.
**Platforms:** Instagram · Facebook · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Threads
Why this server
- **27+ typed tools** — create_post, schedule_post, publish_now, create_draft, upload_media, list_account_feeds, list_post_results, account & webhook management, and more.
- **High-level shortcuts** — publish_now / schedule_post / create_draft / reschedule_post / upload_media collapse common multi-step flows into one call.
- **One-step media upload** — upload_media takes a local file path or a public URL, gets a signed URL, uploads the bytes, and hands back a media_url ready to attach.
- **Per-platform tuning** — platform_configurations models Instagram Reels, X polls, TikTok privacy, YouTube visibility, etc., and stays permissive for new options.
- **Readonly safety mode** — POSTFORME_READONLY=true blocks every write; great for analytics-only sessions.
- **postforme_raw** — call any endpoint for 100% API coverage, even brand-new ones.
- **Resilient client** — Bearer auth, retries on 429/5xx with backoff, actionable error messages.
Install
Or run published (after release) without cloning:
Configuration
Copy .env.example → .env and set your key:
| Variable | Required | Description |
|----------|----------|-------------|
| POSTFORME_API_KEY | ✅ | Your Post for Me API key (Dashboard → Settings → API Keys). |
| POSTFORME_BASE_URL | — | Override the API base URL for self-hosted/open-source deployments. Default https://api.postforme.dev. |
| POSTFORME_READONLY | — | true blocks all write tools (only reads + postforme_raw GET run). |
| POSTFORME_DISABLE_RAW | — | true removes the postforme_raw tool. |
| POSTFORME_TIMEOUT_MS | — | Per-request timeout (default 60000). |
| POSTFORME_MAX_RETRIES | — | Max retries on 429/5xx/network (default 3). |
Test locally
Add to Claude Code
.claude/settings.json → mcpServers:
Add to Claude Desktop
%APPDATA%\Claude\claude_desktop_config.json (Windows) / ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):
Cursor uses the same config shape in its MCP file.
Tools
Social accounts
| Tool | Description |
|------|-------------|
| 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. |