How do I install Post Bridge?

Copy the http config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Post Bridge need an API key?

No required environment variable is listed on this record.

What transport does Post Bridge use?

Post Bridge is reached over HTTP.

When was Post Bridge last checked?

Last checked 2026-11-09. Schedule and publish social media posts to 10 platforms from your AI agent

Post Bridge MCP server

Power your agent

Add this server

The publisher's own URL. Not a PlugMCP endpoint.

Add to Cursor Add in Claude Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Server URL

https://www.post-bridge.com/api/mcp/mcp

The Claude button above opens Claude with the name and URL filled in. You still confirm it there.

shClaude Code

1claude mcp add --transport http io.github.jackfriks-post-bridge https://www.post-bridge.com/api/mcp/mcp

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.jackfriks-post-bridge": {4      "command": "npx",5      "args": [6        "-y",7        "mcp-remote",8        "https://www.post-bridge.com/api/mcp/mcp"9      ]10    }11  }12}

claude_desktop_config.json

Remote · HTTPPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Remote

Transport: http
Version: 1.1.3
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Post Bridge Agent Mode

Give your AI agent the ability to post to 10 social media platforms from a single command.

Supports: Instagram, TikTok, YouTube, X (Twitter), LinkedIn, Facebook, Pinterest, Threads, Bluesky, Google Business

Built on the Post Bridge API. Post Bridge is a social media scheduling tool used by 1,500+ creators and teams to post everywhere from one place.

Agent Plugins standard

This repo is also a portable Agent Plugin (spec 1.0.0), the open packaging standard from Amazon, Cursor, Microsoft, OpenAI, and Vercel. Root plugin.json + mcp.json + skills/ mean any compatible client (Cursor, VS Code, and more as they adopt it) can load the post bridge skill and connect to the hosted MCP server from this one package. Claude Code keeps using .claude-plugin/ as before; both formats live side by side.

What Are Skills?

Skills are markdown files that give AI agents specialized knowledge and workflows for specific tasks. Add this to your project and your AI agent will be able to create, schedule, and publish social media content across 10 platforms.

Install

Skill (works with Claude Code, Cursor, Windsurf, Codex, and other agents):

npx skills add post-bridge-hq/agent-mode

This installs the skills and makes the postbridge-cli CLI available to your agent.

Two skills ship in this repo:

skill	what it does
`post-bridge`	Create, schedule and manage posts across 10 platforms via the Post Bridge API
`b2c-organic-social-media-marketing`	Organic growth coach for B2C apps on TikTok and Instagram, the system behind 500M+ views and 130K+ downloads with no ad spend

Install just one with --skill:

npx skills add post-bridge-hq/agent-mode --skill b2c-organic-social-media-marketing

CLI only (no skill, any terminal):

The CLI is published standalone on npm — no install required, npx fetches it on first use:

npx postbridge-cli setup --key pb_live_xxxxx
npx postbridge-cli accounts

Requires Node.js 18+. Install globally with npm i -g postbridge-cli if you'd rather drop the npx prefix.

Claude Code Plugin:

Add the marketplace and install:

/plugin marketplace add post-bridge-hq/agent-mode
/plugin install post-bridge@post-bridge

Or load locally for development:

claude --plugin-dir ./agent-mode

Cursor:

Open Settings (Cmd+Shift+J)
Go to "Rules & Command" > "Project Rules"
Click "Add Rule" > "Remote Rule (GitHub)"
Enter: https://github.com/post-bridge-hq/agent-mode.git

Manual:

Clone this repository and copy skills/post-bridge/ to your project's .cursor/skills/ or .claude/skills/ directory.

Setup

Sign up at post-bridge.com and connect your social accounts
Enable API access (API Keys page in your dashboard) — $5/month add-on
Run the setup command:

npx postbridge-cli setup --key pb_live_xxxxx

Tip: You can also set the API key as an environment variable instead of running setup: export POST_BRIDGE_API_KEY=pb_live_xxxxx (add it to ~/.zshrc / ~/.bashrc to persist).

Start using it

Ask your AI agent things like:

"Post this to all my social accounts"
"Schedule a post for tomorrow at 9am on Instagram and TikTok"
"Upload this video and post it everywhere"
"How did yesterday's post perform?"
"Show my scheduled posts"
"Delete the draft I made earlier"

What your agent can do

Post to any or all 9 connected platforms in one command
Schedule posts for any date/time
Upload images and videos (automatic format conversion)
Check analytics — views, likes, comments, shares across TikTok, YouTube, Instagram
Manage accounts — list connections, check status
Per-platform overrides — custom captions, TikTok draft mode, YouTube titles, Instagram trial reels, Pinterest boards, etc.

Quick start

# List your connected accounts
npx postbridge-cli accounts

# Post to specific accounts
npx postbridge-cli post --caption "Hello world!" --accounts 1,2,3

# Schedule a post (specific UTC time)
npx postbridge-cli post --caption "Morning post" --accounts 1,2 --schedule "2026-06-20T14:00:00Z"

# Or auto-schedule to your next queue slot
npx postbridge-cli post --caption "Morning post" --accounts 1,2 --use-queue

# Upload media and post with it
npx postbridge-cli upload --file ./video.mp4
npx postbridge-cli post --caption "Check this out" --accounts 1,2,3 --media mid_xxx

# Check analytics, then per-day numbers for one post
npx postbridge-cli analytics
npx postbridge-cli analytics:daily --id <analytics_id>

# File is on someone else's device? Mint a 24h drop page, then list media for the id
npx postbridge-cli upload-link

# Per-platform options, e.g. YouTube title + tags and a TikTok inbox draft
npx postbridge-cli post --caption "New video" --accounts 1,2 --media mid_xxx \
  --platform-config '{"youtube":{"title":"My video","tags":["cooking","easy recipes"]},"tiktok":{"draft":true}}'

# Every command and flag
npx postbridge-cli help

Supported Platforms

Instagram (Reels, Stories, Feed)
TikTok
YouTube (Shorts)
X (formerly Twitter)
LinkedIn
Facebook
Pinterest
Threads
Bluesky

Media requirements

Some platforms can't publish a text-only post and will fail without an image or video:

Platform	Media	Accepts
YouTube	Required	exactly 1 video
TikTok	Required	1 video, or one+ images (photo post)
Instagram	Required	1–10 images/videos; story = exactly 1; no PDFs
Pinterest	Required	1-5 images (2+ publishes as a carousel; all images must share one aspect ratio) or 1 video
X (Twitter)	Optional	up to 4 images, or 1 video
Facebook	Optional	1 video, or one+ images
LinkedIn	Optional	up to 20 images, or 1 video, or 1 PDF
Threads	Optional	up to 20 images/videos
Bluesky	Optional	up to 4 images, or 1 video
Google Business	Optional	text or a single image; no video

You can create a post without media and add it later with posts:update — but it won't publish to a media-required platform until the media exists.

Troubleshooting

"API key not found"

Run the setup command:

npx postbridge-cli setup --key pb_live_xxxxx

Or set the environment variable manually:

export POST_BRIDGE_API_KEY=pb_live_xxxxx

To persist across sessions, add it to your shell profile (~/.bashrc, ~/.zshrc, etc.).

"Node.js is required"

The CLI is a zero-dependency Node.js script and requires Node.js 18+ (for built-in fetch). Install a recent Node.js version, then retry.

API errors (401, 403)

Verify your API key is correct
Check that API access is enabled at post-bridge.com/dashboard/api-keys
Make sure you have an active subscription with the API add-on ($5/month)

Post failed on one platform

Each platform posts independently. If one fails, the others still go through. Use npx postbridge-cli results --post-id <id> to see per-platform status and error details.

MCP Server

Post Bridge also runs a hosted MCP server, so MCP-compatible clients (Claude, ChatGPT, Cursor, and other agents) can connect directly — no CLI, no install.

Endpoint: https://www.post-bridge.com/api/mcp/mcp (streamable HTTP)
Auth: OAuth 2.0 — connect and sign in, no API key needed. (Or pass a pb_live_... key as a Bearer token, see below.)

Connect

Claude or ChatGPT (one-click, OAuth): add a custom connector / app using the endpoint URL above, sign in to Post Bridge, and authorize. Leave any OAuth client ID/secret blank — the server registers the client automatically.

Claude Desktop (via mcp-remote) — add to claude_desktop_config.json:

{
  "mcpServers": {
    "post-bridge": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://www.post-bridge.com/api/mcp/mcp",
        "--header",
        "Authorization: Bearer pb_live_your_api_key_here"
      ]
    }
  }
}

Claude Code / other HTTP MCP clients — add to ~/.claude/settings.json:

{
  "mcpServers": {
    "post-bridge": {
      "type": "http",
      "url": "https://www.post-bridge.com/api/mcp/mcp",
      "headers": { "Authorization": "Bearer pb_live_your_api_key_here" }
    }
  }
}

Tools (14)

list_social_accounts, create_post, update_post, get_post, list_posts, delete_post, list_post_results, upload_media, request_upload_link, list_media, delete_media, list_analytics, get_analytics_daily, sync_analytics

Try it

"Which social accounts do I have connected?"
"Schedule this video to TikTok, Instagram Reels and YouTube Shorts for tomorrow at 9am."
"Which of my posts got the most views in the last 30 days?"

Full setup guide and tool reference: post-bridge.com/mcp/docs

License

MIT

Post Bridge

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Post Bridge?

Does Post Bridge need an API key?

What transport does Post Bridge use?

When was Post Bridge last checked?

Documentation

Post Bridge Agent Mode

Agent Plugins standard

What Are Skills?

Install

Skill (works with Claude Code, Cursor, Windsurf, Codex, and other agents):

CLI only (no skill, any terminal):

Setup

Start using it

What your agent can do

Quick start

Supported Platforms

Media requirements

Troubleshooting

"API key not found"

"Node.js is required"

API errors (401, 403)

Post failed on one platform

MCP Server

Connect

Tools (14)

Try it

Links

License