Publish Directly from ChatGPT, Claude & Cursor to Every Social Channel & Page
Turn any AI assistant into a multi-brand social media publisher. Select your brand, attach visuals in the exact aspect ratio each network prefers, choose between your LinkedIn Personal Profile or Company Pages, Instagram, Threads, Facebook Pages, and Google Business Profile locations, and publish live in a single prompt.
Select the Exact Brand, Channel & Sub-Page
Whether you manage one brand or fifty client workspaces, your AI agent never guesses where a post will go. One call to wordflux_list_brands returns every brand, connected account, and selectable sub-destination.
LinkedIn Personal Profile vs. Company Pages
Target your personal profile with pageId: "profile" or publish to any administered organization page using pageId: "urn:li:organization:..." or by matching pageName.
Multi-Channel Fan-Out in One Prompt
Pass a targets[] array to publish simultaneously to LinkedIn, Instagram, Threads, Google Business Profile, Facebook Pages, X, Pinterest Boards, Bluesky, and Mastodon with platform-tailored captions.
Google Business Locations & Facebook Pages
Route local updates and call-to-action links (ctaUrl) to specific Google Business store locations, individual Facebook Pages, or dedicated Pinterest Boards.
5 Ways AI Agents Can Attach & Publish Images
Visual platforms like Instagram and Pinterest require permanent, high-resolution images, and every network performs better with visuals. Wordflux automatically validates and persists images to Cloudflare R2 before publishing.
1. Direct HTTPS Image URLs
Pass any public HTTPS image URL in imageUrls[]. Wordflux validates DNS/IP safety, downloads the image, verifies PNG/JPEG/WebP/GIF magic bytes, and persists it to Cloudflare R2 before publishing.
2. Base64 & Data URI Images
Pass inline Base64 or data:image/png;base64,... payloads in base64Images[] directly from ChatGPT, Claude artifacts, or custom agent pipelines without needing external image hosting.
3. Local Desktop File Paths
When running @word-flux/mcp-server locally, pass a local file path (such as /Users/you/Desktop/launch-1080x1350.png) in localFilePaths[] or filePath. The MCP client reads the file and uploads it automatically.
4. Automatic Webpage OpenGraph Extraction
Sharing a blog post or product link without an image ready? Pass sourceUrl and Wordflux automatically extracts the page's og:image or twitter:image hero visual and persists it to R2.
5. Wordflux Brand Media Library
Ask your agent to call wordflux_list_media to browse existing visuals already generated or uploaded in your Wordflux workspace and attach them by URL.
Best Image Formats & Aspect Ratios Per Channel
Wordflux embeds these exact Auto-Scheduler aspect ratio guidelines directly into the MCP tool schemas and GET /mcp/brands response so ChatGPT, Claude, and image-generating agents create properly sized visuals every time.
| Channel | Best Aspect Ratios | Recommended Pixels | Sub-Destinations (pageId / pageName) |
|---|---|---|---|
LinkedIn (Personal Profile & Company Pages) | 1:1, 4:5 (primary 1:1) | 1080x1080 (Square) or 1080x1350 (Portrait) | Personal Profile (pageId: "profile") and Company Pages (pageId: "urn:li:organization:..." or pageName) |
Instagram (Business & Creator Accounts) Image Required | 4:5, 1:1 (primary 4:5) | 1080x1350 (4:5 Portrait) or 1080x1080 (1:1 Square) | Connected Instagram Business or Creator Account (pageId or pageName) |
Threads | 1:1, 4:5 (primary 1:1) | 1080x1080 (Square) or 1080x1350 (Portrait) | Connected Threads Profile |
Google Business Profile (Multi-Location) | 1:1, 4:3 (primary 1:1) | 1080x1080 (Square) or 1200x900 (4:3, min 400x300) | Specific Business Locations (pageId: "accounts/.../locations/..." or pageName) |
Facebook Pages | 1:1, 4:5 (primary 1:1) | 1080x1080 (Square) or 1080x1350 (Portrait) | Specific Facebook Pages (pageId or pageName) |
X (Twitter) | 16:9, 1:1 (primary 16:9) | 1920x1080 (16:9 Widescreen) or 1080x1080 (Square) | Connected X Account |
Pinterest Boards Image Required | 2:3, 4:5, 1:1, 9:16, 16:9 (primary 2:3) | 1000x1500 (2:3 Pin) or 1080x1350 (4:5 Portrait) | Specific Pinterest Boards (pageId or pageName) |
Bluesky & Mastodon | 1:1, 16:9 (primary 1:1) | 1080x1080 (Square) or 1920x1080 (Widescreen) | Connected Bluesky / Mastodon Handle |
Complete MCP Tool Suite & Autonomous Discovery
Autonomous agents can self-discover Wordflux via /.well-known/mcp.json or import our OpenAPI 3.1 specification into ChatGPT Custom GPT Actions via /.well-known/openapi-mcp.json.
wordflux_list_organizations
Lists all organizations your account belongs to, along with their brands, roles, subscription tiers, and credits so AI agents can switch workspaces seamlessly.
wordflux_list_brands
Lists all your brands, connected social accounts, selectable destination pages and locations (LinkedIn Personal Profile vs. Company Pages, Facebook Pages, Google Business Locations, Instagram accounts, Pinterest Boards), and optimal image aspect ratios per channel.
wordflux_get_brand_context
Fetches Brand Voices (tone, style, vocabulary, examples) and Context Profiles (rules, target audience, knowledge sources) so AI agents write 100% on-brand.
wordflux_publish_now
Immediately publishes a single post or a multi-channel targets[] payload with images across LinkedIn, Instagram, Threads, Google Business Profile, Facebook, X, Pinterest, Bluesky, Mastodon, and WordPress, or saves as a Draft in your Content Library.
wordflux_create_content
Creates a new single or multi-channel content item in the Wordflux Content Library as a Draft (default), or publishes immediately, or schedules for later.
wordflux_get_schedule
Answers 'What is scheduled for today, tomorrow, or this week?' with full scheduled items, platforms, sub-pages, and media previews.
wordflux_schedule_post
Schedules a post or multi-channel targets[] array with images and first comments for a specific ISO 8601 UTC timestamp, or publishes immediately when publishNow is true.
wordflux_manage_scheduled_post
Reschedules an existing scheduled post to a new date/time, updates caption or first comment text, cancels/unschedules, or publishes immediately.
wordflux_inject_urls_to_autoscheduler
Injects 1 to 20 webpage, news article, blog post, or YouTube URLs directly into Wordflux Auto-Scheduler / Content Radar for automated scraping and multi-channel campaign generation.
wordflux_list_radar_items
Lists discovered articles, RSS feed items, and captured URLs in your Website/Content Radar so your AI agent can recommend what to read or convert into social posts today.
wordflux_generate_linkedin_outreach
Generates and stores personalized 1-to-1 LinkedIn outreach sequences (connection notes under 300 chars, follow-up DMs, and comment replies) for up to 100 prospects using your Brand Voice.
wordflux_upload_media
Ingests an external HTTPS image URL, Base64/Data URI image, or local file path (via @word-flux/mcp-server), validates magic bytes, and stores a permanent Cloudflare R2 URL in your Wordflux Media Library.
{
"mcpServers": {
"wordflux": {
"command": "npx",
"args": [
"-y",
"@word-flux/mcp-server"
],
"env": {
"WORDFLUX_API_URL": "https://api.word-flux.com",
"WORDFLUX_API_KEY": "YOUR_WORDFLUX_MCP_API_KEY"
}
}
}
}curl -X POST "https://api.word-flux.com/mcp/publish" \
-H "Authorization: Bearer YOUR_WORDFLUX_MCP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"brandId": "OPTIONAL_DEFAULT_BRAND_ID",
"targets": [
{
"platform": "linkedin",
"pageId": "profile",
"content": "Excited to share our latest update on LinkedIn!",
"imageUrl": "https://example.com/linkedin-1080x1080.jpg",
"firstComment": "Full details: https://www.word-flux.com"
},
{
"platform": "instagram",
"content": "New release is live! Swipe through the highlights.",
"imageUrl": "https://example.com/instagram-1080x1350.jpg"
},
{
"platform": "threads",
"content": "Shipping fast: our new update is live today.",
"imageUrl": "https://example.com/threads-1080x1080.jpg"
},
{
"platform": "google-business",
"content": "Visit us or check out our newest release online.",
"imageUrl": "https://example.com/google-business-1200x900.jpg"
}
]
}'Built for Zero-Trust AI Workflows
MCP API keys have bounded expiration (1 to 365 days), unique key IDs for instant 1-click revocation, and cannot mutate account passwords or mint additional keys.
All external image URLs undergo DNS and IP validation blocking private subnets and metadata IPs, plus a 10 MB size limit and strict PNG/JPEG/WebP/GIF magic-byte inspection.
Social platform OAuth tokens remain encrypted inside Wordflux. AI agents only receive sanitized page IDs and names, never underlying social credentials.
Everything About Wordflux MCP & AI Agent Publishing
Do I need the Auto-Scheduler enabled to publish via the Wordflux MCP Server?
No. The MCP Server connects directly to Wordflux's core publishing and scheduling engine. You can draft a post with an image inside ChatGPT, Claude, or Cursor and publish it live immediately via wordflux_publish_now (POST /mcp/publish) without enabling the autonomous Auto-Scheduler.
Can I choose between my LinkedIn Personal Profile and a LinkedIn Company Page?
Yes. When your agent calls wordflux_list_brands (GET /mcp/brands), LinkedIn integrations return both your Personal Profile (pageId: "profile") and every administered Company Page (pageId: "urn:li:organization:..."). You can also pass pageName (for example, "Personal Profile" or your company name) and Wordflux resolves the destination automatically.
Can I publish to multiple channels and locations in a single prompt?
Yes. Both wordflux_publish_now and wordflux_schedule_post accept a targets[] array. In a single call, your agent can publish tailored captions and aspect-ratio-matched images to your LinkedIn Company Page, Instagram Business account, Threads profile, Facebook Page, X account, and specific Google Business Profile locations.
How does the AI agent know which image format or aspect ratio each social channel requires?
Every tool schema, OpenAPI specification (/.well-known/openapi-mcp.json), and GET /mcp/brands response includes explicit Auto-Scheduler image format instructions: 4:5 (1080x1350) or 1:1 (1080x1080) required for Instagram; 1:1 or 4:5 for LinkedIn, Threads, and Facebook; 1:1 or 4:3 for Google Business Profile; 16:9 or 1:1 for X; and 2:3 (1000x1500) or 4:5 required for Pinterest.
How do autonomous AI agents discover the Wordflux MCP Server automatically?
Wordflux exposes standard machine-readable discovery endpoints at /.well-known/mcp.json and /.well-known/openapi-mcp.json, along with WebAPI JSON-LD structured data. For ChatGPT Custom GPTs, simply paste https://www.word-flux.com/.well-known/openapi-mcp.json into the 'Import from URL' box in GPT Actions.