Skip to content

Guides

A social media MCP server for Windsurf

Windsurf's MCP configuration lives in mcp_config.json, editable through the Cascade panel's Manage MCP Servers UI or directly on disk. Windsurf doesn't generate the file on first launch, so create it if it isn't there yet.

Browse docs

5 min read

The connection#

PropertyValue
EndpointPOST https://api.skedcast.com/mcp
TransportStreamable HTTP
AuthOAuth 2.1 bearer token (client runs the flow for you) or a SkedCast API key as a bearer token
Tools59 tools — 31 that read (posts, clients, accounts, analytics, reports, best-times, library, webhooks) and 28 that act (compose and edit posts, reschedule/cancel/retry, import media, manage webhooks)

Add a social media MCP server to Windsurf#

Open Windsurf Settings → Manage MCP Servers → View raw config (or run the command palette action "Windsurf: Configure MCP Servers"), which opens mcp_config.json — located at ~/.codeium/windsurf/mcp_config.json on macOS/Linux, or %USERPROFILE%\.codeium\windsurf\mcp_config.json on Windows.

json
{
  "mcpServers": {
    "skedcast": {
      "serverUrl": "https://api.skedcast.com/mcp"
    }
  }
}
mcp_config.json — add a serverUrl entry for a remote server.

Restart Windsurf after saving. Cascade (Windsurf's AI agent panel) will then run through the OAuth sign-in on first use, and its tool picker lists SkedCast's tools alongside anything else you've connected.

mcpwindsurfcascadeai agent

FAQ

Do I have to edit the JSON file by hand?
Not necessarily — Windsurf also has a built-in MCP Marketplace (the MCPs icon in the Cascade panel) for one-click installs of listed servers, but a server not in that marketplace, like a private/custom endpoint, needs the manual mcp_config.json entry above.
The server doesn't appear after I saved the config — what now?
Restart Windsurf — it doesn't hot-reload mcp_config.json. Then check Manage MCP Servers to confirm it shows as connected, not just listed.

Ready to broadcast everywhere?

Sign up free — no credit card. You land on the Free plan, and you can start a one-time 7-day Studio trial from your workspace whenever you are ready. Connect your first accounts, import a batch, and watch one post fan out across every platform.