Open SourcePost for Me MCP Server

MCP Server · TypeScript · MIT

Social media scheduling in natural language.

21 tools that give any AI agent full control over your Post for Me account — schedule posts across 10 platforms, manage social accounts, fetch engagement metrics, and set up webhooks, all without opening a dashboard.

$npx @nerdsnipe-inc/postforme-mcp-server

View on npm View on GitHub ↗

Tools

Platforms

MIT

License

What's inside

One key, 10 platforms

Bluesky, Facebook, Instagram, LinkedIn, Pinterest, Threads, TikTok, TikTok Business, X, and YouTube — a single Post for Me API key unlocks all of them.

Per-platform configuration

Override caption, media, and platform-specific settings per post. Set YouTube privacy status, TikTok duet permissions, Instagram placement, or X poll options — all from a single tool call.

Account feed with metrics

Retrieve every post from a connected account — including posts not made through Post for Me — with engagement metrics: views, likes, follows, and more.

Post previews before publishing

Generate a visual preview of exactly what a post will look like on each platform before you schedule it. No surprises after publish.

Webhook subscriptions

Subscribe to post and account events. Failed deliveries are retried with exponential backoff ~8 times over a day — you won't miss a publish result.

Full test suite

Handler tests for all 21 tools, client tests, and tool registry invariant checks. npm test must pass before any PR merges.

Quick install

npx (no install required)

$npx @nerdsnipe-inc/postforme-mcp-server

pnpm

$pnpm dlx @nerdsnipe-inc/postforme-mcp-server

bun

$bunx @nerdsnipe-inc/postforme-mcp-server

Requires Node.js 18 or later and a Post for Me API key (get one free at app.postforme.dev in under 30 seconds).

Tool coverage

Social Posts

5 tools

pfm_create_post
pfm_get_posts
pfm_update_post
pfm_delete_post

Social Accounts

6 tools

pfm_get_social_accounts
pfm_create_social_account_auth_url
pfm_disconnect_social_account
pfm_update_social_account

Post Results & Previews

3 tools

pfm_get_post_results
pfm_get_post_result
pfm_create_post_previews

Webhooks

5 tools

pfm_create_webhook
pfm_get_webhooks
pfm_update_webhook
pfm_delete_webhook

Account Feeds

1 tools

pfm_get_account_feed (with metrics expand)

Media

1 tools

pfm_create_media_upload_url (signed URL + media_url)

One env var. One key.

POSTFORME_API_KEY is the entire config.

Social account IDs, post IDs, and webhook IDs are all passed as parameters at runtime. The server is generic across any Post for Me account.

Supported platforms: Bluesky · Facebook · Instagram · LinkedIn · Pinterest · Threads · TikTok · TikTok Business · X (Twitter) · YouTube.

Frequently asked

Do I need a Post for Me account?

Yes — the server wraps the Post for Me API. Sign up free at app.postforme.dev, connect your social accounts, and generate an API key from Settings → API.

Can I post to multiple platforms at once?

Yes. Pass multiple account IDs to pfm_create_post and it schedules to all of them. Use platform_configurations to override caption or settings per platform.

What if a post fails on one platform but succeeds on others?

pfm_get_post_results filtered by the post ID shows per-platform outcomes, including error details. Each platform result is independent.

Are engagement metrics available for all platforms?

Most platforms are supported via pfm_get_account_feed with expand=['metrics']. Note: Instagram metrics may take 48h, Bluesky views are unavailable via their API, and LinkedIn metrics require a company page.