Post Bridge

Post Bridge Agent Mode

[License: MIT] [Version] [npm] [Post Bridge API]

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:

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_xxxxxnpx postbridge-cli accounts

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

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

claude --plugin-dir ./agent-mode

Setup

1. Sign up at post-bridge.com and connect your social accounts
2. Enable API access (API Keys page in your dashboard) — $5/month add-on
3. 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 accountsnpx postbridge-cli accounts
# Post to specific accountsnpx 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 slotnpx postbridge-cli post --caption "Morning post" --accounts 1,2 --use-queue
# Upload media and post with itnpx postbridge-cli upload --file ./video.mp4npx postbridge-cli post --caption "Check this out" --accounts 1,2,3 --media mid_xxx
# Check analytics, then per-day numbers for one postnpx postbridge-cli analyticsnpx postbridge-cli analytics:daily --id <analytics_id>
# File is on someone else's device? Mint a 24h drop page, then list media for the idnpx postbridge-cli upload-link
# Per-platform options, e.g. YouTube title + tags and a TikTok inbox draftnpx 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 flagnpx 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:

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

Links

• Post Bridge
• Agent Mode Landing Page
• API Documentation
• MCP Setup

License

MIT