omnipost-social-engine
The Omnipost Social Engine MCP server exposes 12 tools for formatting and managing social media content, threads, hooks, engagement analysis, exports, accessibility, diagnostics, and UTM campaign links.
Format posts: Format/style copy for Twitter, LinkedIn, Bluesky, Threads, Mastodon, Facebook, Instagram with character checks, hashtags, and Unicode typography.
Split threads: Split long text into sentence-aware, platform-limited numbered thread posts.
Generate hooks: Create opening hooks/headlines across multiple copywriting frameworks and niches.
Analyze engagement: Score readiness, readability, sentiment, structure, and optimization tips.
Export campaigns: Export multi-post campaigns as JSON, CSV, Markdown, or text for Buffer/Hootsuite/Typefully/generic presets.
Get diagnostics: Retrieve platform limits, Unicode support, and engine version info.
Audit accessibility: Check alt text against WCAG 2.2 and scan post text for content-warning triggers.
Build UTM URLs: Construct clean campaign tracking URLs with source, medium, campaign, term, and content.
Sanitize URLs: Strip surveillance/click IDs like fbclid and gclid while optionally keeping UTM tags.
Generate campaign links: Create synchronized UTM links across multiple social platforms.
Tag post links: Detect URLs in post copy and replace them with platform-specific UTM campaign URLs.
Generate vanity redirects: Produce standalone HTML redirect pages with Open Graph and Twitter Card metadata.
Provides platform envelope translation and character counting for composing and simulating posts on BlueSky (ATProto), including UTF-8 byte facet validation.
Provides platform envelope translation and character counting for composing and simulating posts on Mastodon, including platform-aware limits.
Provides platform envelope translation and character counting for composing and simulating posts on Threads, including platform-aware limits.
Omnipost Social Engine
Zero-dependency Python 3.9+ multi-platform social copy formatter, sentence-aware thread splitter, copywriting hook generator, WCAG 2.2 alt-text accessibility auditor, UTM campaign URL builder/sanitizer, campaign exporter, and MCP server.
Zoth Studio v2 Dossier: https://zoth.nullai.tech/tools/omnipost-social-engine
Default Loopback Endpoint:
http://127.0.0.1:8091Runtime Dependencies: Zero external Python runtime packages (100% Python
stdlib)License: MIT (100% free and open-source)
Overview
omnipost-social-engine formats and validates posts across X/Twitter (280 chars), Bluesky (300 chars), Threads (500 chars), Mastodon (500 chars), LinkedIn (3,000 chars), Facebook, and Instagram. It ships with a Google Material 3 dark loopback web workstation, deterministic Unicode typography styling (bold, italic, bold_italic, monospace, script, double_struck, sans, underline, strikethrough), sentence-preserving thread segmentation, engagement/readability scoring, ad-tracker parameter stripping (fbclid, gclid, msclkid, twclid), Buffer/Hootsuite/Typefully CSV export, and a 12-tool Model Context Protocol (MCP) server.
Related MCP server: PostMCP MCP Server
Architecture
src/omnipost_social_engine/
├── campaign_exporter.py # Buffer, Hootsuite, Typefully CSV, JSON, and Markdown calendar exporters
├── hook_generator.py # Deterministic hook templates across 9 copywriting frameworks
├── accessibility_synthesizer.py # WCAG 2.2 image alt-text auditor and content-warning trigger scanner
├── utm_builder.py # UTM parameter builder, click-ID URL sanitizer, and vanity HTML redirector
├── mcp_server.py # JSON-RPC 2.0 stdio MCP server exposing 12 social & UTM tools
├── ui_server.py # Loopback HTTP API + Google Material 3 Studio UI (127.0.0.1:8091)
└── cli.py # Unified CLI entrypoint (`omnipost`)Quickstart
git clone https://github.com/1nc0gn30/omnipost-social-engine.git
cd omnipost-social-engine
python3 -m pip install -e ".[dev]"
# Launch the loopback web workstation on http://127.0.0.1:8091
omnipost serve --host 127.0.0.1 --port 8091Run directly from a source checkout without installing:
PYTHONPATH=src python3 -m omnipost_social_engine.cli serve --host 127.0.0.1 --port 8091CLI & MCP Usage
CLI Subcommands
# View CLI help
omnipost --help
# Format and style a post for X/Twitter, LinkedIn, Bluesky, Threads, or Mastodon
omnipost format "Shipping deterministic Python tools." --platform bluesky --style bold --tags python,mcp --json
# Split long-form copy into numbered thread segments
omnipost split examples/developer-thread/draft.txt --platform twitter --limit 280 --numbering-format fraction --json
# Generate copywriting hooks across 9 frameworks
omnipost hooks "local-first developer tools" --niche tech --framework contrarian --count 5 --json
# Score readability, structure, and engagement readiness (0-100)
omnipost analyze "Here is why zero-dependency CLIs start faster." --platform linkedin --json
# Export a campaign schedule to Buffer/Hootsuite/Typefully CSV, JSON, or Markdown
omnipost export examples/launch-campaign/campaign.json --format csv --preset buffer
# Audit image alt-text accessibility and content-warning triggers
omnipost accessibility --alt "Terminal screenshot showing JSON output" --platform mastodon --json
# Build UTM URLs, strip tracking IDs, or generate multi-platform campaign links
omnipost utm --url "https://nullai.tech" --platform twitter --campaign q4_launch --json
omnipost utm --url "https://example.com/?fbclid=abc123&utm_source=x" --sanitize --json
# Print platform character limits and runtime diagnostics
omnipost platform --json
# Launch stdio MCP server or print client configs
omnipost mcp
omnipost mcp-config --client claudeZothOS v3.4.0 CLI Integration
On ZothOS v3.4.0 workstations, omnipost is available in /usr/local/bin/omnipost:
omnipost platform --json
omnipost web # Starts http://127.0.0.1:8091
omnipost desktop # Launches the Electron workstation shellModel Context Protocol (MCP) Tools
{
"mcpServers": {
"omnipost": {
"command": "omnipost",
"args": ["mcp"]
}
}
}MCP Tool | Description |
| Format and style social copy with platform character checks and Unicode typography |
| Split long-form text into numbered, sentence-bounded thread segments |
| Generate opening hooks across 9 copywriting frameworks ( |
| Score readability, sentiment, structure, and engagement readiness ( |
| Export multi-post campaigns to Buffer/Hootsuite/Typefully CSV, JSON, or Markdown |
| Return platform character budgets, Unicode support status, and engine diagnostics |
| Audit image alt-text against WCAG 2.2 checks and scan for content-warning triggers |
| Construct clean UTM campaign tracking URLs |
| Strip surveillance click IDs ( |
| Generate synchronized UTM tracking URLs across multiple social platforms |
| Detect bare URLs inside post copy and tag them with platform UTM parameters |
| Generate a standalone HTML redirect page with Open Graph and Twitter Card metadata |
HTTP API Reference
When running on http://127.0.0.1:8091:
Method | Endpoint | Description |
|
| Service health status and Python runtime version |
|
| Platform character limits and engine diagnostics |
|
| Ready-to-paste MCP client configurations ( |
|
| Format and apply Unicode typography to post text |
|
| Split long text into numbered thread posts |
|
| Generate hook candidates by topic, niche, and framework |
|
| Compute engagement readiness and readability metrics |
|
| Export campaign schedules ( |
|
| Run WCAG 2.2 alt-text and content-warning checks |
|
| UTM link construction, sanitization, and vanity redirect generation |
Testing & Verification
# Run the pytest suite
python3 -m pytest -q
# Run CLI self-test
omnipost test
# Scan repository with gitleaks
gitleaks detect --source . --no-banner --redactSupport
Omnipost Social Engine is 100% free and open-access software with zero paywalls. Optional community support is available via:
Stripe: Buy Us a Coffee
Solana Tip:
GG2eQbVh8ut1BK6j1A2tz7pSySdLpD38BgyEhGcxdXoK
License
MIT License — Engineered by Neal Frazier Tech (@1nc0gn30) • NullAI Platform. Copyright (c) 2026 Neal Frazier. See LICENSE for full text.
Available Tools
12 toolsomni_analyze_engagementB
Analyze text for engagement potential, viral readiness score (0-100), readability metrics, sentiment, structure, and actionable optimization tips.
Inputs: text (required), platform.
omni_audit_accessibilityB
Audit alt-text against WCAG 2.2 accessibility standards and detect content warning (CW) triggers for sensitive posts.
Inputs: alt_text, platform, post_text.
omni_build_utm_urlC
Build a clean campaign tracking URL with source, medium, campaign, term, and content parameters.
Inputs: medium (required), source (required), base_url (required), campaign (required), +2 more.
omni_export_campaignB
Export a multi-post social campaign into Buffer/Hootsuite CSV, JSON bundle, Markdown calendar, or plain text.
Inputs: campaign (required), format, preset.
omni_format_postB
Format, optimize and style social media posts for target platform (twitter, linkedin, bluesky, threads, mastodon) with character checks and Unicode typography styles.
Inputs: text (required), trim, style, hashtags, +1 more.
omni_generate_campaign_linksB
Generate synchronized UTM campaign tracking links across multiple social platforms simultaneously.
Inputs: base_url (required), campaign (required), content, platforms.
omni_generate_hooksB
Generate high-converting viral hooks, headlines, and opening lines based on proven copywriting frameworks.
Inputs: topic (required), count, niche, framework.
omni_get_diagnosticsA
Retrieve system diagnostics, platform character limits, Unicode font support status, and engine version info.
Inputs: platform.
omni_sanitize_urlA
Strip surveillance and ad network click IDs (fbclid, gclid, msclkid, twclid, etc.) from a URL.
Inputs: url (required), keep_utm.
omni_split_threadB
Split long-form copy into platform-optimized thread posts with character limit adherence, natural sentence/paragraph breaks, and numbering markers.
Inputs: text (required), limit, platform, numbering, +1 more.
omni_tag_post_linksC
Auto-detect URLs in social post body and replace them with platform-specific campaign UTM URLs.
Inputs: text (required), campaign (required), platform (required), content.
omni_vanity_redirectA
Generate a standalone zero-dependency HTML vanity redirect page with Open Graph and Twitter Card tags.
Inputs: title (required), target_url (required), delay_ms, og_image, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Most tools occupy clearly separate lanes: formatting, thread splitting, hooks, engagement analysis, export, accessibility audit, and diagnostics are all distinct operations. The only soft overlap is among the UTM tools (omni_build_utm_url, omni_generate_campaign_links, omni_tag_post_links), though descriptions distinguish single-URL construction, cross-platform link sets, and in-body auto-replacement. omni_vanity_redirect is also a different product surface (HTML page generation) from the rest of the copy/tracking workflow.
All names follow a clean omni_ snake_case convention with a consistent prefix, making them easy to scan and group. The only deviation is verb style: omni_vanity_redirect uses a noun phrase rather than an action verb, while every other tool leads with generate/split/analyze/export/audit/build/sanitize/tag/get.
Twelve tools sit squarely in the well-scoped 3-15 range, with each one covering a distinct step in the post-creation pipeline (hook generation, formatting, splitting, auditing, tracking, exporting). No tool appears redundant or filler.
The surface covers the copy lifecycle end-to-end: ideation (hooks), formatting and threading, quality checks (engagement, accessibility), tracking URL generation/sanitization, and campaign export. The main gap is that a "social engine" has no publish/schedule or media/alt-text generation step — only auditing of existing alt-text — so agents hit a dead end at delivery.
Maintenance
Related MCP Connectors
Schedule and publish posts and short videos to every major social platform from any AI agent.
Draft, schedule and publish social posts to nine platforms from any AI agent.
Draft, schedule and publish social media posts from any AI agent.
Schedule and publish social media posts to 10 platforms from your AI agent
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI agents to create, schedule, and manage social media posts across 10 platforms via a unified API.-

PostMCP MCP Serverofficial
AlicenseAqualityBmaintenanceEnables AI assistants to manage social media publishing across platforms like LinkedIn, Twitter, Facebook, Instagram, Threads, and Bluesky.754 npmMIT
AdaptlyPostofficial
AlicenseAqualityBmaintenanceGives AI agents the ability to schedule and publish social media posts to Instagram, TikTok, YouTube, X, LinkedIn, Facebook, Pinterest, Threads, and Bluesky. Create, schedule, and bulk-plan posts with per-platform captions, then check per-platform results and retry failures.82MIT- AlicenseNot gradedqualityBmaintenanceEnables AI agents to post, schedule, thread, delete, and analyze social media posts across platforms like X, Bluesky, LinkedIn, and Instagram through a single MCP interface.107 npmMIT