Developer Documentation: MCP Streamable HTTP & OpenAPI 3.1

Advanced MCP Server, 42 Agent Tools & OpenAPI Reference

Complete technical specification for engineers, custom AI builders, and automation pipelines. Configure remote JSON-RPC, inspect all 42 MCP endpoints, integrate OpenAPI 3.1 Actions, or authenticate with scoped Bearer API keys and OAuth 2.1 PKCE.

Protocol & Discovery Summary
HTTP Streamable
Remote MCP Endpoint
https://api.word-flux.com/mcp
MCP Discovery Manifest
https://www.word-flux.com/.well-known/mcp.json
OpenAPI 3.1 Schema
https://www.word-flux.com/.well-known/openapi-mcp.json
OAuth 2.1 Protected Resource Metadata
https://www.word-flux.com/.well-known/oauth-protected-resource
Client Transport & Auth Setup

How to Connect Your AI Assistant in 60 Seconds

Connect Claude, Gemini, Antigravity, Cursor, ChatGPT Actions, or custom scripts directly to our online Remote MCP Server with OAuth 2.1 or scoped Bearer tokens.

Recommended: Online Remote MCP Server (1-Click OAuth 2.1)No Local Install or API Key Required

Add our Remote MCP URL in Claude, Gemini, Antigravity, or Cursor, sign in on the browser OAuth 2.1 screen, and start publishing with zero npm installs or copied secrets.

https://api.word-flux.com/mcp
1
Add URL
Paste api.word-flux.com/mcp
2
Sign In
OAuth 2.1 opens in browser
3
Approve
Grant access in 1 click
4
Publish
Draft or publish live

How to Add an MCP Server to Gemini Web

Remote MCP (OAuth 2.1)

Connect Gemini Web & Gemini Enterprise directly to https://api.word-flux.com/mcp with 1-click OAuth 2.1.

Step-by-Step Setup

  1. 1
    Open Extensions or MCP Integrations in Gemini

    In Gemini Web (or Gemini Enterprise / Workspace), open Settings > Extensions / Connected Apps / MCP Integrations and click 'Add MCP Server' or 'Add Custom Integration'.

  2. 2
    Enter the Wordflux Remote MCP Server URL

    Paste https://api.word-flux.com/mcp as the Remote MCP Server URL and select OAuth 2.1 authentication (discovery metadata loads automatically from /.well-known/oauth-protected-resource).

  3. 3
    Sign in and approve workspace access

    Gemini redirects you to Wordflux's secure OAuth 2.1 authorization page (/mcp-authorize). Sign in to your Wordflux account and click Approve.

  4. 4
    Draft, schedule, and publish in Gemini chat

    Once connected, ask Gemini to inspect your brands, match your Brand Voice, and publish or schedule posts with visuals across LinkedIn, Instagram, Threads, and Google Business Profile.

What to Say Once Connected

Click any prompt below to copy and try it in Gemini Web:

Advanced Configuration (JSON, CLI & API)
Desktop apps, IDEs, or CI/CD runners
{
  "setupType": "Remote MCP Server (OAuth 2.1)",
  "serverUrl": "https://api.word-flux.com/mcp",
  "authType": "OAuth 2.1 Authorization Code Flow",
  "authorizationEndpoint": "https://api.word-flux.com/mcp/oauth/authorize",
  "tokenEndpoint": "https://api.word-flux.com/mcp/oauth/token",
  "discoveryEndpoint": "https://www.word-flux.com/.well-known/mcp.json"
}
Looking for headless, CI/CD, or automated REST publishing?Generate scoped, brand-restricted, revocable Bearer API keys inside Organization Settings.
Open Key Manager
Granular Destination Payloads

Deterministic Brand, Channel & Sub-Page Routing

One call to wordflux_list_brands enumerates every connected integration ID, platform sub-page ID, and location name so agents never guess targets.

Identity Routing

LinkedIn Personal Profile vs. Company Pages

Target personal profiles with pageId: "profile" or administered organization pages using pageId: "urn:li:organization:..." or matching pageName.

Multi-Channel & Multi-Site targets[] Fan-Out

Pass a targets[] array to POST /mcp/publish targeting multiple social networks or CMS instances via integrationId.

Google Business Locations & CTAs

Route local updates and call-to-action links via ctaUrl to specific Google Business Profile locations, Facebook Pages, or Pinterest Boards.

Cloudflare R2 Media Pipeline

5 Programmatic Image Ingestion Paths

Wordflux validates DNS/IP safety, checks image magic bytes, and persists uploads to Cloudflare R2 automatically across every agent transport.

Channel Aspect Ratios & Pixel Matrix
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. Direct Chat Image Attachments

Drop or attach an image directly in your AI chat and ask your assistant to upload it via base64Images[] or imageUrls[]. Wordflux persists it to Cloudflare R2 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.

42 Built-In Agent Tools

Complete MCP Tool Suite & Autonomous Discovery

Every workspace capability is exposed as a typed MCP tool and REST endpoint with automatic discovery via /.well-known/mcp.json and /.well-known/openapi-mcp.json.

MCP Discovery Manifest
https://www.word-flux.com/.well-known/mcp.json
OpenAPI 3.1 Schema (ChatGPT)
https://www.word-flux.com/.well-known/openapi-mcp.json
Browse 42 typed MCP tools & REST endpoints by workflow
POST /mcp/publishDirect One-Step Publish

wordflux_publish_now

Sends directly in one step to any configured social channel (LinkedIn, Instagram, Threads, Google Business Profile, Facebook, X, Pinterest, Bluesky, Mastodon) or CMS site (one or multiple WordPress websites, Shopify, Webflow, Ghost, Custom Webhook, or Hosted Blog via integrationId/pageName) without creating a draft campaign first. Wordflux logs the backing campaign automatically.

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/contentSearch Campaigns

wordflux_list_content

Searches campaigns and drafts across titles, source text, and post body copy so Claude or Gemini can locate existing campaigns to update or schedule.

GET /mcp/content/:contentIdFull Asset Copy

wordflux_get_content

Fetches full untruncated copy, per-asset assetIds, destination pages, attached imageUrls, and scheduled posts before editing.

POST /mcp/content/updateEdit & Add Channels

wordflux_update_content

Revises existing asset copy and visuals in place or adds new platform channels to the same campaign without creating duplicate drafts, syncing pending scheduled posts automatically.

POST /mcp/content/deleteClean Up Drafts

wordflux_delete_content

Removes a single platform asset or moves an entire campaign to Trash while automatically cancelling any pending scheduled jobs.

POST /mcp/campaignMulti-Channel Batch

wordflux_create_campaign

Creates a multi-platform campaign with distinct asset variations across connected social channels, CMS blogs, and Hosted Public Pages in one call.

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.

GET /mcp/pendingApproval Queue

wordflux_get_ready_content

Lists automated and drafted posts waiting in the review queue with full untruncated copy, Client Review Links, and attached media.

POST /mcp/approveQueue Approval

wordflux_approve_post

Approves a single pending post or batch-approves all pending posts for a brand when publishing under human oversight.

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/public-pageHosted SEO Blog

wordflux_manage_public_page

Publishes or unpublishes campaigns and assets on Wordflux Hosted Public Pages with custom slugs, tags, and author profiles.

POST /mcp/content-extrasReview Feedback & History

wordflux_manage_content_extras

Fetches client review feedback (get_review_feedback), restores trashed items, reverts versions, moves campaigns between brands, and manages author profiles.

Claude Desktop / Cursor / Antigravity (mcp_config.json)
{
  "mcpServers": {
    "wordflux": {
      "url": "https://api.word-flux.com/mcp",
      "headers": {
        "Authorization": "Bearer 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 '{
    "organizationId": "OPTIONAL_ORGANIZATION_ID",
    "brandId": "OPTIONAL_DEFAULT_BRAND_ID",
    "mode": "schedule",
    "scheduledAt": "2026-11-15T14:00:00Z",
    "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"
      }
    ]
  }'
Zero-Trust Protocol Security

Scoped Tokens, SSRF Protection & HMAC Webhooks

Give autonomous agents controlled workspace access while keeping brand permissions, external media checks, and underlying social tokens locked down server-side.

Scoped Grants, Draft-Only & Brand Allowlists

Restrict any API key or OAuth 2.1 grant to Full Access (mcp:tools), Draft-Only (mcp:tools:draft_only), or Read-Only (mcp:tools:read_only), optionally pinned to specific brands with signed HMAC-SHA256 webhooks.

SSRF & Magic-Byte Media Validation

External image URLs undergo DNS/IP validation blocking private subnets and metadata IPs, a 10 MB size cap, and strict PNG/JPEG/WebP/GIF magic-byte inspection.

Zero Social Token Exposure

Social platform OAuth tokens remain encrypted inside Wordflux. AI agents only see sanitized page IDs and names, never third-party platform credentials.

Technical FAQ

Architecture, Endpoints & Protocol Questions

Do I have to create a Wordflux campaign draft first, or can I send directly to socials, WordPress, or Shopify?
You can send directly in one step whenever your channels are configured. Call wordflux_publish_now (or wordflux_schedule_post) with your target platform or targets[] array to publish straight to social channels, one or multiple WordPress websites, Shopify, Webflow, Ghost, Custom Webhooks, or your Hosted Blog. Pass integrationId (or pageName) from wordflux_list_brands to target specific WordPress or Shopify sites. Wordflux automatically records the backing campaign behind the scenes so tracking, edits, and analytics still work.
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.
Do I need to generate an API key before connecting Claude, Antigravity, or Cursor?
No. With our online Remote MCP Server (https://api.word-flux.com/mcp), you can sign in with 1-click OAuth 2.1 directly in your browser without manually generating or copying an API key. Scoped Bearer API keys are also available in Organization Settings for scripts and Custom GPTs.
How do Draft-Only, Read-Only, and Brand Allowlists protect multi-brand agencies?
Every API key and OAuth connection can be scoped to Full Access (mcp:tools), Draft-Only (mcp:tools:draft_only), or Read-Only (mcp:tools:read_only), and optionally pinned to an explicit list of allowed brands. Draft-Only agents can research sources, generate visuals, create drafts, and read client review feedback without ever publishing live or billing your workspace.
Can external agents and automations subscribe to Wordflux events via webhooks?
Yes. You can configure signed outbound HMAC-SHA256 webhooks (either in Organization Settings or via wordflux_manage_integrations) for radar.item_discovered, lead.opportunity_found, content.feedback_received, post.published, and post.failed.
How can someone without technical skills connect Wordflux to their AI?
Connecting takes under 60 seconds with no terminal commands or local installs. In Claude.ai Web, Claude Desktop, Google Antigravity, or Cursor, simply add the Remote MCP URL https://api.word-flux.com/mcp, sign in on the OAuth 2.1 popup, and click Approve. You can immediately ask your AI to list your brands and publish social posts.
Risk-Free 14-Day Free Trial

Put Your Entire Content Engine on Autopilot Today

Connect your website or channels in 2 minutes. Start publishing on LinkedIn, Instagram, X, Facebook, Pinterest, Bluesky, Mastodon, and Google Business with zero manual copy-pasting.

Looking for the browser companion?Download Chrome & Edge Plugin
14-day free trial, €0 charged todayCancel anytime with 1 clickFree Done-For-You Onboarding includedCustom Workflows Built on Request