> ## 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.

# Social Media Scheduling (via Post Bridge)

> Learn how to connect Post Bridge to Notis as a custom MCP server so Notis can create, schedule, publish, and analyze social posts across your connected accounts.

[Post Bridge](https://post-bridge.com?atp=DM0Bke)’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.

<Tip>
  That split is important: Notis is your creation and validation layer, while Post Bridge is your execution layer for social publishing.
</Tip>

## Prerequisites

* An active [Post Bridge](https://post-bridge.com?atp=DM0Bke) subscription

* At least one connected social media account in [Post Bridge](https://post-bridge.com?atp=DM0Bke)

* *(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](https://post-bridge.com?atp=DM0Bke).

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](https://post-bridge.com?atp=DM0Bke).

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](https://app.notis.ai) 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.

| Tool                   | What it does                                                                |
| ---------------------- | --------------------------------------------------------------------------- |
| `list_social_accounts` | List connected social accounts (IDs, platforms, usernames)                  |
| `create_post`          | Create and schedule a post (or save as a Post Bridge draft with `is_draft`) |
| `list_posts`           | List posts with optional filters (platform/status)                          |
| `get_post`             | Fetch full details of a single post by ID                                   |
| `update_post`          | Update a scheduled or draft post (caption, schedule, accounts, media)       |
| `delete_post`          | Delete a scheduled or draft post (published posts cannot be deleted)        |
| `list_analytics`       | Retrieve analytics for posts (views/likes/comments/shares)                  |
| `sync_analytics`       | Trigger a fresh analytics sync across connected platforms                   |
| `list_post_results`    | Check per-platform posting results (success/failure + errors)               |
| `upload_media`         | Upload media from a public URL and get a reusable `media_id`                |
| `list_media`           | List uploaded media files                                                   |
| `delete_media`         | Delete 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.