FluxSocial

Add to your AI

Remote MCP server (streamable HTTP). Most clients sign you in with the provider on first use.

Claude Code

claude mcp add --transport http fluxsocial https://www.fluxsocial.app/api/mcp

Claude Desktop, Cursor, Windsurf (mcp config)

{
  "mcpServers": {
    "fluxsocial": {
      "url": "https://www.fluxsocial.app/api/mcp"
    }
  }
}

ChatGPT: Settings → Connectors → add a custom connector with the URL above.

How to call FluxSocial from code (MCP)

Remote MCP over streamable HTTP with the official SDKs: initialize, list its tools, then call_tool / callTool. It asks callers to sign in (OAuth or an API key from its provider): pass the token as an Authorization header or let your client run the OAuth flow.

Python

# pip install mcp
import asyncio
from mcp import ClientSession
from mcp.client.streamable_http import streamablehttp_client

async def main():
    async with streamablehttp_client("https://www.fluxsocial.app/api/mcp") as (read, write, _):
        async with ClientSession(read, write) as session:
            await session.initialize()
            tools = await session.list_tools()
            print([t.name for t in tools.tools])

asyncio.run(main())

TypeScript

// npm i @modelcontextprotocol/sdk
import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";

const client = new Client({ name: "my-agent", version: "1.0.0" });
await client.connect(new StreamableHTTPClientTransport(new URL("https://www.fluxsocial.app/api/mcp")));
console.log((await client.listTools()).tools.map((t) => t.name));

A2A vs MCP: which one to use

Call it with the Rooms SDK

Through the Rooms switchboard (a Rooms specialist answers if it doesn't). SDK docs

// npm i https://rooms.aurmada.com/sdk/rooms-a2a-0.1.0.tgz
import { Rooms } from "rooms-a2a";
const r = await new Rooms().ask("…", { agent: "fluxsocial" });

# pip install https://rooms.aurmada.com/sdk/rooms_a2a-0.1.0-py3-none-any.whl
from rooms_a2a import Rooms
r = Rooms().ask("…", agent="fluxsocial")

Track record

Uptime

Collecting: shown after 3 daily checks.

Calls via Rooms (30 days)

0

No calls through Rooms in the last 30 days yet. Rooms only counts what it brokers, hosts or checks; nothing is estimated.

Tools (18)

• Check credit balance get_credit_balance
  Check your remaining FluxSocial credit balance. Credits are consumed by content generation (text: 5-20, images: 50, videos: 1200, kinetic videos: 400-600, kinetic edits: 100 credits).
• Preview credit cost preview_cost
  Preview the credit cost for a generation before running it. Use this to check if the user has enough credits.
• Generate post ideas generate_content
  Generate social media post suggestions with AI-written captions, titles, hashtags, and platform-specific adaptations. Returns multiple text suggestions (title, body, tags). For IMAGE format, each suggestion includes imagePrompts — use gene…
• Get a post suggestion get_content
  Retrieve a previously generated content suggestion by its ID. Returns the full suggestion including title, body, tags, images, and any posts made from it.
• Generate an image generate_image
  Generate an AI image for a specific content suggestion. Costs 50 credits. When called without a customPrompt, the API automatically uses the suggestion's stored imagePrompts[imageIndex] — no need to pass the prompt manually. Call this afte…
• Publish a post post_content
  Publish content immediately to one or more social media platforms. For scheduling at a future time, prefer the dedicated schedule_content tool. Use list_accounts first to get valid accountId and platform values. For image posts, call gener…
• Schedule a post schedule_content
  Schedule content for publishing at a specific future date and time. Provide an ISO 8601 datetime (e.g. "2025-12-25T10:00:00Z"). Use get_optimal_time to find the best posting time based on Content DNA analysis. Posts are published within ~2…
• Find the best time to post get_optimal_time
  Get the AI-recommended optimal posting time based on Content DNA analysis and platform engagement patterns. Returns a suggested datetime, confidence score, and reasoning. Use the returned scheduledDateTime with schedule_content.
• Cancel a scheduled post cancel_scheduled_post
  Cancel a previously scheduled post. Only works for posts with status SCHEDULED.
• Check post status check_post_status
  Check whether a suggestion has been posted and to which platforms. Returns posting status per platform with post URLs.
• Generate a video generate_video
  Generate an AI video using Google Gemini Omni. Costs 1200 credits per ~8 seconds. Video generation is ASYNC - this returns an operationId immediately. You must then poll check_video_status until the video is ready (typically 30-120 seconds…
• Check video status check_video_status
  Check the status of an async video generation. Call this after generate_video, generate_kinetic_video or edit_kinetic_video to poll for completion. When status is 'completed', the response includes the videoUrl. Poll every 10-15 seconds.
• Generate an animated text video generate_kinetic_video
  Generate a kinetic video: an animated video made of text, shapes and illustrations. It has no real footage and no people. Best for offers, prices, stats, schedules, menus, openings and announcements, where the words matter most. For footag…
• Edit an animated text video edit_kinetic_video
  Change a finished kinetic video without starting over, e.g. 'make the price bigger', 'use red instead of blue', 'end with our website'. Costs 100 credits. Only works on videos made by generate_kinetic_video that have status 'completed'. Ev…
• Upload your own media upload_media
  Upload a user's own photo or video for posting. The user must provide an HTTPS link to their media (e.g. from Google Drive, Dropbox, iCloud, Imgur, or any public URL). Processes images to Instagram-optimal 1080x1080 and uploads to blob sto…
• List social accounts list_accounts
  List the user's connected social media accounts (Instagram, TikTok, etc.). Each account has an id, platform, username, and follower count. Use this to find accountIds for post_content.
• List businesses list_businesses
  List the user's businesses. Each business represents a brand or project (e.g. 'My Yoga Studio', 'Downtown Café') with its own social accounts and content. Use the returned business ID for generate_content. Also returns the saved brand prof…
• Save the business brand profile update_business_profile
  Save a business's brand profile once so every future post uses it. Call this when the user describes their business or brand, or when generate_content reports the brand profile is incomplete, instead of repeating brand details in each gene…

Automated check: 80/100

Last run 2026-10-14 14:24 UTC. What we measured, not a guarantee.

• 10/10Every URL is https.
• 30/40Answers with a sign-in requirement (OAuth or API key), as many hosted MCP servers do.
• 15/1518 tools listed in its server card.
• 10/10MCP server card at https://www.fluxsocial.app/.well-known/mcp/server-card.json.
• 10/10Has a homepage or documentation link.
• 5/5Answered in 1406 ms.
• 0/10Not claimed with a domain proof yet.