Model Context Protocol (MCP) & OpenAPI 3.1 Agent Publishing

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.

Instant Live Publishing
Personal vs. Company Pages
5-Way Image Ingestion
Scoped & Revocable Keys
Granular Destination Control

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.

Cloudflare R2 Media Pipeline

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.

ChatGPT / Web / CDN

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.

AI-Generated Visuals

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.

Claude / Cursor / Antigravity

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.

Zero-Image Fallback

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.

Approved Brand Assets

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.

Auto-Scheduler Optimal Format Specifications

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.

ChannelBest Aspect RatiosRecommended PixelsSub-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
19 Built-In Agent Tools

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.

GET /mcp/organizationsMulti-Org Switcher

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.

GET /mcp/brandsBrand & Page Discovery

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.

GET /mcp/brand-contextBrand Voice & Context

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.

POST /mcp/publishInstant Publish or Draft

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.

POST /mcp/contentContent Library Drafts

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.

GET /mcp/scheduleToday & Week Schedule

wordflux_get_schedule

Answers 'What is scheduled for today, tomorrow, or this week?' with full scheduled items, platforms, sub-pages, and media previews.

POST /mcp/scheduleCalendar Scheduling

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.

POST /mcp/schedule/manageReschedule & Edit

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.

POST /mcp/auto-scheduler/injectAuto-Scheduler URLs

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.

GET /mcp/radarContent Radar

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.

POST /mcp/linkedin-outreach1-to-1 LinkedIn Outreach

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.

POST /mcp/upload-mediaR2 Image Upload

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.

Claude Desktop / Cursor / Antigravity (mcp_config.json)
{
  "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"
      }
    }
  }
}
Direct Multi-Channel & Sub-Page Publish (POST /mcp/publish)
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"
      }
    ]
  }'
Hardened Agent Security

Built for Zero-Trust AI Workflows

Scoped & Revocable API Keys

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.

SSRF & Magic-Byte Media Validation

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.

Zero OAuth Token Exposure

Social platform OAuth tokens remain encrypted inside Wordflux. AI agents only receive sanitized page IDs and names, never underlying social credentials.

Frequently Asked Questions

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.