Social Post Flow

Name: Social Post Flow
Author: socialpostflow

by socialpostflowversion 1.0.0i★ –iRuns in the cloud

Registry namecom.socialpostflow/mcp

Install

Overview

Description from the maker (original English)

Schedule and publish social media posts to Facebook, X, LinkedIn, Instagram, Threads and more.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs in the cloud
Transport: Streamable HTTP
Category: Marketing & social media

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on the maker’s server: what you ask it goes through their server.
The registry lists no key to fill in.

You need

Runs in the cloudNothing to install; it connects over the internet

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Works in Claude on the web, desktop and mobile:

Open Settings → Connectors
Press Add custom connector
Paste the address below and press Add
If it asks you to sign in, sign in with the maker

https://app.socialpostflow.com/mcp

Run this in your terminal

claude mcp add --transport http socialpostflow https://app.socialpostflow.com/mcp

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "socialpostflow": {
      "url": "https://app.socialpostflow.com/mcp"
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "socialpostflow": {
      "type": "http",
      "url": "https://app.socialpostflow.com/mcp"
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

ChatGPT connects only to servers on the internet:

Open ChatGPT on the web → Settings → Connectors (Apps)
Press Create or Add (some plans need Developer mode under Advanced first)
Paste the address below, give it a name and save
If it asks you to sign in, sign in with the maker

https://app.socialpostflow.com/mcp

Menu names can differ slightly by plan and over time.

Your choice stays on this device in a cookie; no account needed.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

We have not read this server’s tool list yet; we check endpoints in rotation.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 6, 2026

✓ Pass
Maker matches the repo
The registry name was verified against the domain socialpostflow.com (the registry checks domain ownership)
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
… Not checked yet
Endpoint responds
Not checked yet; we check endpoints in rotation
… Not checked yet
Sign-in with OAuth
Not checked yet; we check endpoints in rotation
… Not checked yet
No hidden instructions in tool descriptions
Not checked yet; we read the tool list when we check the endpoint

Compared with others in Marketing & social mediai

More stars than 0% of the other 2969 servers in this category
Published to the registry more recently than 82% of the other 2969 servers in this category
Basic checks equal to or better than 100% of the other 2969 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Social Post Flow safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs in the maker’s cloud. Connect over the internet with nothing to install, but what you send passes through the maker’s servers.

Is it still maintained?

The GitHub repo last changed –, and the latest version (1.0.0) reached the registry 7 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. It connects by URL, so apps that accept remote MCP servers work too, such as ChatGPT in developer mode.

What can I use instead?

In the same category: MCP YouTube Transcript, Google Analytics MCP, BibiGPT YouTube Video Summarizer

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

MCP YouTube Transcript

by jkawamoto

An MCP server retrieving transcripts of YouTube videos

Runs on your computer★ 495MITUpdated 9 days ago

Install

Google Analytics MCP

by surendranb

GA4 MCP server for AI agents: schema discovery, server-side aggregation, analysis-ready defaults.

Runs on your computer★ 244MITUpdated 9 days ago

Install

BibiGPT YouTube Video Summarizer

by JimmyLv

AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.

Runs in the cloud★ 137MITUpdated 10 days ago

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Social Post Flow CLI

Social media automation for AI agents — schedule posts across 12+ networks programmatically.

A zero-dependency Node.js CLI wrapper around the Social Post Flow API. Designed for use with AI agents (Claude Code, Cursor, Windsurf, Codex, OpenAI SDKs) and for shell scripting / CI workflows.

Supports: Facebook, X (Twitter), LinkedIn, Instagram (Feed + Stories), Threads, Pinterest, TikTok, Mastodon, Bluesky, Telegram, Google Business Profiles, and more.

Pick your install

Using	Use this
Claude Code	The plugin (see Install as a Claude Code plugin below) — ships the MCP server pre-wired
Claude Desktop, ChatGPT Desktop	The MCP server (one-click connect, no setup)
Cursor, Codex, Warp, Cline, OpenCode, other agents	The skill (see Install as a skill below)
Shell scripts, CI/CD, your own tooling	The CLI (see Install as a CLI below)

You can use the skill and the CLI together. The skill teaches the agent *how* to use Social Post Flow; the CLI is what the agent actually runs.

Install as a Claude Code plugin

The plugin bundles the MCP server config and a Claude-native skill in one install:

/plugin marketplace add socialpostflow/claude-marketplace

/plugin install socialpostflow@socialpostflow

Or, once approved in the community marketplace:

/plugin marketplace add anthropics/claude-plugins-community

/plugin install socialpostflow@claude-community

On first use, Claude Code opens a browser for you to sign in with your Social Post Flow account and approve access — no personal access token needed.

Note: If you install the plugin, don't also add the MCP server manually in Claude Desktop settings — you'll register the same endpoint twice. Pick one.

Install as a skill

Adds the Social Post Flow skill to your agent so it can compose and schedule posts in natural language. This is the CLI-driven skill (agent shells out to spf). Claude Code users should install the plugin above instead — it uses the MCP server, no CLI needed.

Single-command install (any agent that reads `~/.claude/skills/`):

mkdir -p ~/.claude/skills/socialpostflow && \

curl -L https://raw.githubusercontent.com/socialpostflow/socialpostflow-cli/main/agent-skill/socialpostflow/SKILL.md \ -o ~/.claude/skills/socialpostflow/SKILL.md

Multi-agent install (Cursor, Codex, Warp, Cline, OpenCode, etc.):

npx skills add socialpostflow/socialpostflow-cli

When prompted, pick the agents you want to install for.

Then ask your agent things like:

"Post this text to my X and LinkedIn accounts."

"Schedule a Monday motivation post for 9am next week."

"Queue up these three blog promos across all my channels."

The agent learns from agent-skill/socialpostflow/SKILL.md, which documents the post types, scheduling model, and common workflows.

Install as a CLI

Globally via npm:

npm install -g socialpostflow-cli

Or run directly via npx without installing:

npx socialpostflow-cli --help

Or clone the repo and run the script directly (zero dependencies):

git clone https://github.com/socialpostflow/socialpostflow-cli.git

cd socialpostflow-cli node scripts/socialpostflow.js --help

Requires Node.js 18 or later (for built-in fetch).

Authentication

You need a Social Post Flow account with API access. Grab your personal access token from your profile page, then:

spf setup --key spf_xxxxxxxxxxxxxxxx

This verifies the token against the API and saves it to ~/.socialpostflow/credentials.json (chmod 600).

Alternatively, set the environment variable:

export SOCIALPOSTFLOW_API_TOKEN=spf_xxxxxxxxxxxxxxxx

Quick start

# List your connected social profiles

spf profiles

Post to one profile, immediately

spf post -c "Hello world!" -i 42

Post to multiple profiles

spf post -c "Big announcement coming soon" -i 42,87,103

Schedule for a specific time

spf post -c "Happy Monday!" -i 42 --schedule-type scheduled -s "2026-07-20T09:00:00Z"

Add to the user's queue (uses their configured queue interval)

spf post -c "Quick tip..." -i 42 --schedule-type queue_end

List recent posts

spf posts --status posted --order-by posted_at --order desc

Delete a scheduled post

spf delete 12345

Commands

Command	Description
`spf setup --key`	Verify and store a personal access token.
`spf whoami`	Show the authenticated user's profile, subscription state, and stats.
`spf profiles [--post-type T]`	List connected social profiles. Optionally filter by post type.
`spf posts [--status S] [--profile-id N]`	List posts. Filter by status or profile.
`spf post -c "..." -i id1,id2 [options]`	Create a post (see options below).
`spf show`	Show details of a single post.
`spf delete`	Delete a post. Stops it publishing if scheduled.

`spf post` options

Flag	Description
`-c, --content`	Post text. Required unless `--type story`.
`-i, --profile-ids`	Comma-separated profile IDs (required).
`-t, --type`	Post type: `text` (default), `link`, `image`, `story`, `pin`, `tiktok`, `google`.
`-m, --media`	Comma-separated public image/video URLs.
`-u, --url`	URL to attach (required for `--type link`).
`--first-comment`	First-comment text. Not supported on Mastodon, TikTok, Telegram, Google.
`--schedule-type`	`immediate` (default), `queue_end`, `queue_start`, `scheduled`.
`-s, --scheduled-at`	ISO 8601 timestamp (required when `--schedule-type=scheduled`, must be in future).

See agent-skill/socialpostflow/SKILL.md for the full post-type rules (what each type requires and forbids).

All output is JSON

Every command writes JSON to stdout. Errors write JSON to stderr with a non-zero exit code:

PROFILES=$(spf profiles)

TWITTER_ID=$(echo "$PROFILES" | jq -r '.data[] | select(.provider=="x") | .id')

spf post -c "Hello from a shell script" -i "$TWITTER_ID"

Environment variables

Variable	Default	Description
`SOCIALPOSTFLOW_API_TOKEN`	—	Your API token. Alternative to `spf setup`.
`SOCIALPOSTFLOW_API_URL`	`https://app.socialpostflow.com/api`	Override the API base URL (useful for testing).

Examples

See examples/ for shell scripts demonstrating common workflows:

post-everywhere.sh — post the same content to all connected text-capable profiles
schedule-week.sh — schedule a week's worth of posts using the queue
github-actions.yml — publish a blog post announcement from a GitHub Action

Troubleshooting

"Not authenticated" — Run spf setup --key or set SOCIALPOSTFLOW_API_TOKEN.

"HTTP 401 from API" — Your token is invalid. Get a valid token from https://app.socialpostflow.com/profile.

"HTTP 422 from API" — Validation error. The details payload tells you which field failed. Common causes: invalid post_type/schedule_type combination, scheduled time in the past, missing required media_urls for image/story/pin/tiktok posts.

"HTTP 429 from API" — Daily post limit reached for that profile. The user needs to wait or upgrade their plan.

License

MIT — see LICENSE.

Social Post Flow

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Marketing & social mediai

Common questions

Alternatives

MCP YouTube Transcript

Google Analytics MCP

BibiGPT YouTube Video Summarizer

README from the maker

Social Post Flow CLI

Pick your install

Install as a Claude Code plugin

Install as a skill

Install as a CLI

Authentication

Quick start

Post to one profile, immediately

Post to multiple profiles

Schedule for a specific time

Add to the user's queue (uses their configured queue interval)

List recent posts

Delete a scheduled post

Commands

spf post options

All output is JSON

Environment variables

Examples

Troubleshooting

License

Links

`spf post` options