Skip to main content

Documentation Index

Fetch the complete documentation index at: https://help.notis.ai/llms.txt

Use this file to discover all available pages before exploring further.

Post Bridge’s MCP server lets Notis schedule and publish social posts, upload media, and retrieve analytics across your connected social accounts — while Notis stays responsible for content creation, review, and approval.

​
What this setup does

In this setup, Notis handles the AI work: generating post ideas, drafting captions, creating images, reviewing outputs, and deciding when content is ready to publish. Post Bridge handles the publishing actions through MCP: listing accounts, creating/scheduling posts, uploading media, and fetching analytics.
That split is important: Notis is your creation and validation layer, while Post Bridge is your execution layer for social publishing.

​
Prerequisites

  • An active Post Bridge subscription
  • At least one connected social media account in Post Bridge
  • (For most MCP clients) A Post Bridge API key

​
Post Bridge MCP connection

Post Bridge exposes an HTTP MCP endpoint:
  • Endpoint: https://www.post-bridge.com/api/mcp/mcp
  • Auth: Authorization: Bearer pb_live_your_api_key_here
  • Transport: HTTP (Streamable HTTP)

​
Step 1: Connect social accounts in Post Bridge

  1. Log in to Post Bridge.
  2. Connect at least one social media account.
  3. Confirm the account appears in your social accounts list (you’ll verify again via MCP later).

​
Step 2: Get your Post Bridge API key

  1. Open the API Keys dashboard in Post Bridge.
  2. Create a new key (or copy an existing one).
  3. Keep it secure — Notis will use it to authenticate against Post Bridge.

​
Step 3: Add Post Bridge as a custom MCP in Notis

  1. Open the Notis Portal and go to Settings → Integrations.
  2. Click Add MCP.
  3. Name: Enter Post Bridge.
  4. Description: Give Notis context on when to use this MCP. For example:
“Use Post Bridge to schedule, publish, and manage social media posts across connected accounts. It can upload media, schedule posts, and retrieve analytics.”
  1. Server URL:
https://www.post-bridge.com/api/mcp/mcp
  1. Authentication: Select Headers, then add:
  • Key: Authorization
  • Value: Bearer pb_live_your_api_key_here (replace with your real API key)
  1. (Optional) If you prefer stricter permissions, disable Use all tools and select only what you need.
  2. Click Save.
Once saved, Post Bridge’s tools are immediately available to Notis across all your channels — WhatsApp, Telegram, iMessage, Slack, email, and Voice Mode.

​
Step 4: Verify the connection

Useful first checks:
  1. List your connected accounts (to confirm Notis can see destinations).
  2. Create a draft or scheduled post (to confirm publishing flow works).
  3. List posts / analytics (to confirm read access).

​
Tool reference (11 tools)

Post Bridge’s MCP server exposes 11 tools. Your AI will discover these automatically — you just ask in plain language.
ToolWhat it does
list_social_accountsList connected social accounts (IDs, platforms, usernames)
create_postCreate and schedule a post (or save as a Post Bridge draft with is_draft)
list_postsList posts with optional filters (platform/status)
get_postFetch full details of a single post by ID
update_postUpdate a scheduled or draft post (caption, schedule, accounts, media)
delete_postDelete a scheduled or draft post (published posts cannot be deleted)
list_analyticsRetrieve analytics for posts (views/likes/comments/shares)
sync_analyticsTrigger a fresh analytics sync across connected platforms
list_post_resultsCheck per-platform posting results (success/failure + errors)
upload_mediaUpload media from a public URL and get a reusable media_id
list_mediaList uploaded media files
delete_mediaDelete an uploaded media file (only if unused by any post)

​
Example workflow: let Notis create, let Post Bridge publish

  1. Create the content in Notis — Generate the creative, storyboard, or image.
  2. Validate in Notis — Check brand voice, clarity, platform fit, and compliance.
  3. Upload media via Post Bridge — Use upload_media for assets hosted at a public URL.
  4. Create a scheduled post via Post Bridge — Use create_post with scheduled_at and the selected social_accounts.
  5. Check delivery — Use list_post_results after publishing.
  6. Review performance — Use sync_analytics then list_analytics.

​
Good to know

  • Drafts: is_draft saves the post in Post Bridge only. It does not create a native draft inside each social platform.
  • Media lifecycle: Media may be cleaned up automatically after the last post using it has published. If you reuse media across multiple scheduled posts, keep an eye on the lifecycle behavior.
  • Deleting posts: You can only delete scheduled or draft posts. Published posts cannot be deleted via the API.

​
Troubleshooting

  • Authentication fails: Confirm the API key is valid and sent as a Bearer token in the Authorization header.
  • No accounts found: Confirm you connected at least one social account in Post Bridge.
  • Posting fails: Use list_post_results to inspect platform-specific errors.

​
Summary

Post Bridge provides an HTTP MCP endpoint that Notis can connect to with a Bearer-authenticated API key. It exposes tools for listing social accounts, uploading media, scheduling/publishing posts, and retrieving analytics — enabling a workflow where Notis creates and validates content while Post Bridge executes publishing and measurement.