socialfanout-mcp

A tiny, zero-dependency Model Context Protocol server that gives your AI agent one safe tool to publish to every social network through Social Fanout.

It's a thin stdio client over the Social Fanout REST API — your agent never touches raw platform tokens. One key, one call, fan out to up to 20 destinations.

FANOUT_API_KEY=spk_live_… npx socialfanout-mcp

You need a Social Fanout API key — get one free at https://socialfanout.com/signup.

Add it to your agent

The server speaks MCP over stdio, so any MCP-capable client can launch it. Set two env vars:

| Variable | Required | Default | Notes | | ---------------------- | -------- | --------------------------- | --------------------------------------- | | FANOUT_API_KEY | yes | — | Your Social Fanout API key (spk_…). | | FANOUT_API_BASE_URL | no | https://socialfanout.com | Override only when self-hosting. |

Claude Desktop / Claude Code

{
  "mcpServers": {
    "socialfanout": {
      "command": "npx",
      "args": ["-y", "socialfanout-mcp"],
      "env": {
        "FANOUT_API_KEY": "spk_live_your_key",
        "FANOUT_API_BASE_URL": "https://socialfanout.com"
      }
    }
  }
}

Cursor / VS Code / other MCP clients

Use the same command / args / env shape in your client's MCP config. Codex, Cursor, and VS Code's agent mode all accept this form.

Tools

| Tool | Purpose | | ------------------------- | ---------------------------------------------------------- | | fanout_health | Check the Social Fanout API is live. | | fanout_list_providers | List configured providers and their capabilities. | | fanout_list_connections | List the social accounts connected to your API key. | | fanout_start_oauth | Get a provider OAuth URL (no API key in the URL). | | fanout_publish_post | Publish a post through an existing connection. |

Connect accounts (OAuth) from the dashboard — the agent publishes through those connections, so a leaked prompt can never leak your accounts.

How it works

socialfanout-mcp makes plain HTTPS calls to the Social Fanout REST API using your key. It has no npm dependencies — just Node's built-in fetch — so npx is fast and the install footprint is effectively zero.

Links

• Product & docs: https://socialfanout.com
• For agents: https://socialfanout.com/agents
• API reference: https://socialfanout.com/docs/api

License

MIT © Muse Nexus