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.
- 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
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.
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/mcp1-Click Connect Shortcuts (Claude.ai, Cursor & VS Code)
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
- 1Open 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'.
- 2Enter 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).
- 3Sign 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.
- 4Draft, 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.
Click any prompt below to copy and try it in Gemini Web:
Advanced Configuration (JSON, CLI & API)
{
"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"
}How to Add an MCP Server to Claude.ai Web
OAuth 2.1 Authorization Code FlowConnect Claude.ai in your browser directly to https://api.word-flux.com/mcp with 1-click authorization.
Step-by-Step Setup
- 1Open Pre-Filled Connectors Modal in Claude.ai Web
Click the 1-click button below to launch Claude.ai with WordFlux and https://api.word-flux.com/mcp pre-filled (or manually open Settings > Connectors > Add custom connector).
- 2Paste the Wordflux Remote MCP URL
Set the connector name to 'Wordflux' and enter https://api.word-flux.com/mcp as the Remote MCP Server URL, then click Add.
- 3Click Connect and approve permissions
Click Connect next to Wordflux. Claude opens Wordflux's secure OAuth 2.1 authorization screen (/mcp-authorize). Click Approve to grant access.
- 4Start publishing from Claude chat
Enable the Wordflux connector in any chat and ask Claude to inspect your Brand Voice, draft campaigns, or publish directly.
Click any prompt below to copy and try it in Claude.ai Web:
Advanced Configuration (JSON, CLI & API)
{
"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"
}How to Connect an MCP Server to Google Antigravity
Remote MCP (OAuth 2.1, No API Key Required)Connect directly to https://api.word-flux.com/mcp or via ~/.gemini/config/mcp_config.json.
Step-by-Step Setup
- 1Connect to the Wordflux Remote MCP URL
In your Antigravity conversation, ask it to connect to the remote MCP server at https://api.word-flux.com/mcp, or open Advanced Configuration to copy the 6-line snippet into mcp_config.json.
Prompt to paste into chat:Connect to the Wordflux remote MCP server at https://api.word-flux.com/mcp - 2Authorize with 1-click OAuth 2.1
Antigravity opens Wordflux's secure OAuth 2.1 sign-in screen (/mcp-authorize). Sign in to your Wordflux account (or create one) and click Approve to grant access.
- 3Start publishing immediately
Your session is connected directly over HTTPS with no local Node.js packages or manual API keys required. Switch to Manual API Key if you prefer a scoped Bearer token.
Click any prompt below to copy and try it in Google Antigravity:
Advanced Configuration (JSON, CLI & API)
{
"mcpServers": {
"wordflux": {
"url": "https://api.word-flux.com/mcp"
}
}
}How to Add a Remote MCP Server to Claude Desktop
Remote MCP (OAuth 2.1, No API Key Required)Add https://api.word-flux.com/mcp via Connectors or claude_desktop_config.json.
Step-by-Step Setup
- 1Open Claude Desktop Connectors or Settings
In Claude Desktop, open Settings > Connectors and click Add Custom Connector, or open Developer > Edit Config to edit claude_desktop_config.json.
- 2Enter the Remote MCP URL
Enter https://api.word-flux.com/mcp as the server URL (or paste the 6-line JSON snippet from Advanced Configuration). No local installation or secret API key is required.
- 3Authorize in your browser
Click Connect and approve access on Wordflux's OAuth 2.1 authorization screen (/mcp-authorize). Claude will immediately load your Wordflux tools.
- 4Start drafting and publishing
Ask Claude to list your brands, inspect your Brand Voice, or draft and publish multi-channel social posts.
Click any prompt below to copy and try it in Claude Desktop:
Advanced Configuration (JSON, CLI & API)
{
"mcpServers": {
"wordflux": {
"url": "https://api.word-flux.com/mcp"
}
}
}How to Add an MCP Server to Cursor
Remote MCP (OAuth 2.1, No API Key Required)Add https://api.word-flux.com/mcp via Cursor Settings > MCP or .cursor/mcp.json.
Step-by-Step Setup
- 1Install with 1 Click or Open Cursor MCP Settings
Click the 1-click Cursor install link below to pre-load WordFlux automatically, or open Cursor Settings (Command + ,) > Features > MCP > '+ Add New MCP Server'.
- 2Set the Wordflux Remote MCP URL
Enter https://api.word-flux.com/mcp as the server URL, or paste the 6-line JSON snippet into .cursor/mcp.json.
- 3Authorize via OAuth 2.1
Click Connect when Cursor prompts you to authenticate, and approve workspace access on the Wordflux OAuth 2.1 screen (or toggle Manual API Key to use a Bearer token).
- 4Ready to publish and schedule
Cursor confirms your active workspace, brand names, and connected social pages. You can now publish directly from your code workspace.
Click any prompt below to copy and try it in Cursor:
Advanced Configuration (JSON, CLI & API)
{
"mcpServers": {
"wordflux": {
"url": "https://api.word-flux.com/mcp"
}
}
}How to Connect ChatGPT Custom GPT Actions to Wordflux
OpenAPI 3.1 SpecificationImport our schema into Custom GPT Actions with a scoped Wordflux API key.
Step-by-Step Setup
- 1Create or edit a Custom GPT
In ChatGPT, click Explore GPTs in the sidebar, click '+ Create' in the top-right, and switch to the Configure tab.
- 2Import the Wordflux OpenAPI 3.1 schema
Scroll down to Actions, click 'Create new action', click 'Import from URL', paste https://www.word-flux.com/.well-known/openapi-mcp.json and click Import.
- 3Configure Bearer API Key Authentication
Under Authentication, click the gear icon, select 'API Key', set Auth Type to 'Bearer', and paste your scoped MCP API key generated from Wordflux Organization Settings.
- 4Save and publish
Save your Custom GPT. You can now prompt ChatGPT to publish to LinkedIn, Instagram, Threads, and Google Business Profile with images.
Click any prompt below to copy and try it in ChatGPT Actions:
Advanced Configuration (JSON, CLI & API)
{
"setupType": "ChatGPT Custom GPT Actions / Remote OpenAPI Import",
"openApiSchemaImportUrl": "https://www.word-flux.com/.well-known/openapi-mcp.json",
"authenticationType": "API Key (Bearer)",
"apiKey": "YOUR_WORDFLUX_MCP_API_KEY",
"examplePrompt": "Publish this update with the attached 4:5 image to our LinkedIn Company Page, Instagram, Threads, and Amsterdam Google Business location."
}How to Publish via the Wordflux MCP REST API & cURL
Direct HTTP JSON-RPCExecute direct HTTP POST /mcp/publish payloads from any script or CI/CD runner.
Step-by-Step Setup
- 1Generate a scoped MCP API Key
Go to Wordflux Organization Settings > API Keys and create a key with your chosen expiration (30 to 365 days) and permission scope.
- 2Send Bearer authorized POST requests
Pass your key in the Authorization: Bearer header to https://api.word-flux.com/mcp/publish or any MCP endpoint.
Click any prompt below to copy and try it in Direct REST API / cURL:
Advanced Configuration (JSON, CLI & API)
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"
}
]
}'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.
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.
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.
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. 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.
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.
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.
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.
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_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.
wordflux_get_content
Fetches full untruncated copy, per-asset assetIds, destination pages, attached imageUrls, and scheduled posts before editing.
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.
wordflux_delete_content
Removes a single platform asset or moves an entire campaign to Trash while automatically cancelling any pending scheduled jobs.
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.
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_get_ready_content
Lists automated and drafted posts waiting in the review queue with full untruncated copy, Client Review Links, and attached media.
wordflux_approve_post
Approves a single pending post or batch-approves all pending posts for a brand when publishing under human oversight.
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_manage_public_page
Publishes or unpublishes campaigns and assets on Wordflux Hosted Public Pages with custom slugs, tags, and author profiles.
wordflux_manage_content_extras
Fetches client review feedback (get_review_feedback), restores trashed items, reverts versions, moves campaigns between brands, and manages author profiles.
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_manage_brand
Creates, updates, or deletes brands (colors, industry, website, timezone, preferred topics) or toggles organization public profiles.
wordflux_manage_context_profile
Lists, creates, updates, deletes, or auto-generates Context Profiles from a website URL and attaches knowledge sources.
wordflux_manage_brand_voice
Lists, creates, updates, deletes, uploads writing samples to, or analyzes Brand Voice profiles.
wordflux_manage_prompts
Lists, creates, updates, and deletes reusable workspace prompt templates across your team.
wordflux_list_media
Browses brand visuals, uploaded assets, and AI-generated images stored in your workspace Media Library.
wordflux_upload_media
Ingests an external HTTPS image/PDF URL, Base64/Data URI, local file, ChatGPT file ref, or raw SVG markup and stores a permanent Cloudflare R2 URL.
wordflux_generate_visual
Generates on-brand AI images or fetches royalty-free stock photos with optional Brand Template overlays, attaching directly to a campaign.
wordflux_generate_carousel
Creates multi-slide branded carousel slide PNGs plus an optional swipeable LinkedIn PDF and attaches them directly in place.
wordflux_inject_urls_to_autoscheduler
Injects 1 to 20 webpage, news article, blog post, or YouTube URLs directly into Wordflux Auto-Scheduler / Content Automation for automated scraping and multi-channel campaign generation.
wordflux_list_automation_items
Lists discovered articles, RSS feed items, and captured URLs in your Content Automation inbox so your AI agent can recommend what to read or convert into social posts today.
wordflux_inspect_page_sections
Inspects any webpage URL and suggests CSS contentSelectors and excludeSelectors for precision Content Automation scraping.
wordflux_test_automation_extraction
Dry-runs Content Automation extraction with any of 8 reading strategies and CSS selectors before saving a monitored feed.
wordflux_manage_automation_sources
Creates, previews, updates, or deletes Web/RSS/Sitemap/WordPress Content Automation feeds, YouTube channels and presets, Google News/Trends trackers, and webhooks.
wordflux_configure_automation_autopilot
Reads or updates Content Automation autopilot quotas, time slots, reading strategies, and platforms (with human review safety lock).
wordflux_manage_automation_item
Converts, saves, or dismisses Content Automation items, refreshes thumbnails, syncs sources, or runs and monitors the Auto-Scheduler pipeline.
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_get_analytics
Fetches live social engagement metrics (impressions, reach, follower growth, engagement rate), Hosted Public Page views and top pages, plus publishing totals.
wordflux_get_activity_logs
Reads audit logs and Auto-Scheduler logs with full MCP tool attribution, timestamps, and before/after state.
wordflux_get_credits_and_billing
Checks AI credits, subscription tier limits, and usage, or generates Stripe Checkout links for upgrades and add-ons.
wordflux_manage_integrations
Manages CMS and social integrations, OAuth connect links, and signed outbound HMAC webhooks (list_webhooks, create_webhook, delete_webhook, test_webhook).
wordflux_manage_social_inbox
Reads live timelines, inspects audience comments on published posts, and replies directly from your AI agent.
wordflux_request_login
Sends a 6-digit email verification code for zero-config conversational login or new-user signup directly inside your AI chat.
wordflux_verify_login
Verifies the 6-digit email code, mints a scoped MCP key, and automatically caches credentials locally in ~/.wordflux/credentials.json with strict 0600 permissions.
wordflux_auth_status
Inspects active authenticated account status, permission scope, brand allowlist, and organization access inside your AI conversation.
wordflux_logout
Clears locally cached CLI/STDIO credentials from ~/.wordflux/credentials.json on the current machine.
{
"mcpServers": {
"wordflux": {
"url": "https://api.word-flux.com/mcp",
"headers": {
"Authorization": "Bearer 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 '{
"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"
}
]
}'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.
Architecture, Endpoints & Protocol Questions
Do I have to create a Wordflux campaign draft first, or can I send directly to socials, WordPress, or Shopify?
Do I need the Auto-Scheduler enabled to publish via the Wordflux MCP Server?
Can I choose between my LinkedIn Personal Profile and a LinkedIn Company Page?
Can I publish to multiple channels and locations in a single prompt?
How does the AI agent know which image format or aspect ratio each social channel requires?
How do autonomous AI agents discover the Wordflux MCP Server automatically?
Do I need to generate an API key before connecting Claude, Antigravity, or Cursor?
How do Draft-Only, Read-Only, and Brand Allowlists protect multi-brand agencies?
Can external agents and automations subscribe to Wordflux events via webhooks?
How can someone without technical skills connect Wordflux to their AI?
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.