Post for Me MCP Pro

io.github.helbertparanhosPublished by GitHub account helbertparanhosv1.0.0Updated Oct 24, 2026

Publish, schedule and analyze social posts across 9 platforms via the Post for Me API.

VerifiedSTDIODesktop onlyCommunication & CollaborationBusiness & CommerceMedia & Design

Overview

AI-generated overview

Local MCP server that lets an assistant publish, schedule, edit and analyze social posts across nine platforms through the Post for Me API.

What you can do
Manage connected social accounts: list, inspect, connect via credentials or OAuth URL, update and disconnect them, and read feed engagement metrics. Create, publish, schedule, reschedule, edit, list and delete posts across accounts. Check per-platform publish results and preview how a post renders. Upload media from a local file path or public URL and get a media URL to attach. Manage webhook subscriptions for events. Call any versioned API endpoint directly through a raw escape hatch.
When to use it
Useful when you want an assistant to draft, schedule or immediately publish social content to Instagram, Facebook, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky or Threads, and to pull back per-platform results and engagement data without writing SDK code.
Requirements
Runs as a local Node.js process, typically via npx or a built build directory, configured in the MCP client. Requires a Post for Me API key in POSTFORME_API_KEY and network access to the Post for Me API. Optional variables set a base URL, a readonly mode, disabling the raw tool, a timeout and retry count.
Before you install
The API key grants posting rights on connected accounts; keep it out of shared configs. Write tools publish, schedule, edit, delete posts, connect or disconnect accounts and manage webhooks, so actions are publicly visible and hard to undo. POSTFORME_READONLY=true blocks writes for analytics-only use. The raw tool can reach any versioned endpoint; disable it with POSTFORME_DISABLE_RAW. Media uploads read local files and fetch remote URLs.

Installation

In SourceWeft

  1. Open Post for Me MCP Pro in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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.

[npm version] [License: MIT] [GitHub Stars] [GitHub Forks] [GitHub Issues] [Glama Quality]

[TypeScript] [Node.js] [MCP] [Claude Code] [Cursor] [Claude Desktop]

[Instagram] [YouTube] [LinkedIn] [Buy Me A Coffee] [Strat Academy]

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

bash
npm installnpm run build

Or run published (after release) without cloning:

bash
npx -y postforme-mcp-pro

Configuration

Copy .env.example → .env and set your key:

VariableRequiredDescription
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

bash
npx @modelcontextprotocol/inspector node dist/index.js

Add to Claude Code

.claude/settings.json → mcpServers:

json
"postforme": {  "command": "node",  "args": ["projects/postforme-mcp-pro/dist/index.js"],  "env": { "POSTFORME_API_KEY": "pfm_xxx" }}

Add to Claude Desktop

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

json
"postforme": {  "command": "node",  "args": ["/abs/path/projects/postforme-mcp-pro/dist/index.js"],  "env": { "POSTFORME_API_KEY": "pfm_xxx" }}

Cursor uses the same config shape in its MCP file.

Tools

Social accounts

ToolDescription
list_social_accountsList connected accounts (filter by platform/username).
get_social_accountGet one account by id.
create_social_accountConnect an account by supplying credentials.
update_social_accountUpdate stored credentials/metadata.
create_auth_urlStart the OAuth connect flow (returns a URL).
disconnect_social_accountRevoke access for an account.
list_account_feedsAnalytics: recent feed + engagement metrics for an account.

Posts

ToolDescription
create_postCreate a post (publish now, schedule, or draft) across accounts.
publish_nowShortcut: publish immediately.
schedule_postShortcut: schedule for an ISO-8601 time.
create_draftShortcut: save as draft.
get_postGet a post by id.
list_postsList posts (filter by status).
update_postEdit caption/media/accounts/schedule/config.
reschedule_postShortcut: change a scheduled time.
delete_postDelete a post.

Results & previews

ToolDescription
list_post_resultsAnalytics: per-platform publish outcomes.
get_post_resultOne post result by id.
create_post_previewPreview how a post renders per platform.

Media

ToolDescription
create_media_upload_urlGet a signed upload URL (2-step flow).
upload_mediaOne-step: upload a local file or remote URL → returns media_url.

Webhooks

ToolDescription
list_webhooks · get_webhook · create_webhook · update_webhook · delete_webhookManage event subscriptions.

Escape hatch

ToolDescription
postforme_rawCall any /v1/... endpoint directly (method, path, params, body).

Companion skill

/postforme (in skill/SKILL.md) orchestrates these tools into guided workflows: post, schedule, campaign, analytics, accounts, media. Copy it into .claude/skills/ to use it in Claude Code.

Example

You: post "Lançamos a v2 🚀" no instagram e no x, com a imagem ./hero.png→ list_social_accounts            (get the instagram + x account ids)→ upload_media { file_path: "./hero.png" }   → media_url→ create_post_preview             (optional, confirm look)→ publish_now { social_accounts: [...], caption: "...", media: [{ url: media_url }] }→ list_post_results               (report success/links per platform)

Comparison with the official MCP

postforme-mcp-proofficial post-for-me-mcp
Tool model27 typed tools, one per operation2 tools (doc-search + code-execution sandbox)
CallsDirect tool callsModel must write SDK code in a sandbox
Shortcutspublish_now / schedule_post / create_draft / upload_media—
SafetyPOSTFORME_READONLY mode + SSRF/file-read hardening—
Escape hatchpostforme_raw (any /v1 endpoint)code execution
Companion skill/postforme guided workflows—

Security

upload_media hardens remote fetches against SSRF (DNS resolution + public-unicast IP validation, no redirects, size cap) and restricts local file reads to recognized media extensions (optionally to POSTFORME_MEDIA_DIR). postforme_raw paths are validated to stay on the versioned API surface. See REVIEW.md for the full audit.

License

MIT © Helbert Paranhos / Strat Academy

Source: README.md at commit 420ca07

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts