Verified August 2026

Give Windsurf the ability to post to social media

Windsurf can publish to TikTok, Instagram, Facebook, YouTube, LinkedIn, X, Reddit, Telegram, Bluesky, Mastodon and Discord once you connect PostWire as an MCP server. Below is the exact config for Windsurf — including the detail that makes a copied config fail silently.

Where the config goes

ScopePath
macOS / Linux~/.codeium/windsurf/mcp_config.json
Windows%USERPROFILE%\.codeium\windsurf\mcp_config.json

Create the file if it is not there — Windsurf does not generate it on first launch.

The config

{
  "mcpServers": {
    "postwire": {
      "command": "npx",
      "args": [
        "-y",
        "postwire-mcp"
      ],
      "env": {
        "POSTWIRE_API_KEY": "pw_live_your_key"
      }
    }
  }
}

Or point at the hosted server instead

No local process, no Node required — Windsurf talks to PostWire over HTTP.

{
  "mcpServers": {
    "postwire": {
      "serverUrl": "https://postwire.io/api/mcp",
      "headers": {
        "Authorization": "Bearer pw_live_your_key"
      }
    }
  }
}

The mistake that makes this fail silently

For a remote server Windsurf uses serverUrl where most other clients use url (it accepts both, but every Windsurf example you will find uses serverUrl). It also supports ${env:VAR_NAME} interpolation in command, args, env, serverUrl and headers, so the key does not have to sit in the file in plaintext.

Check it worked

Open Cascade and check the MCP panel lists postwire with its tools.

What it can do once connected

ToolWhat it does
generate_postsOne prompt in, a native draft per network out — respecting each one's character limit, hashtag rules and link conventions.
post_to_socialPublish to one or many networks in a single call.
get_post_statusCheck what happened to a post after it was accepted.
list_platformsWhich networks are available and which need approval.
my_accountPlan, usage and which brands are connected.

A prompt like "write a launch post for our new feature and publish it to TikTok, LinkedIn and Bluesky" becomes two tool calls: one to draft a native version per network, one to publish.

Networks differ more than people expect — X caps at 280 characters against YouTube's 5,000, Reddit has no hashtags, and TikTok, YouTube and Instagram all refuse text-only posts. See what breaks between any two networks.

Get an API key free →

Questions people actually ask

Can Windsurf post to social media?
Yes, once you connect an MCP server that can publish. PostWire is one: add it to Windsurf with the config on this page and it gets five tools, including one that writes a native post per network and one that publishes.
Where does the MCP config live for Windsurf?
macOS / Linux: ~/.codeium/windsurf/mcp_config.json; Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json
Do I need approval from TikTok or Meta first?
No. PostWire has already been through those reviews, so you publish through its approved apps. Telegram, Bluesky, Mastodon and Discord need no review from anyone.

Source for the Windsurf config format: Windsurf Cascade MCP docs. Using a different client? See all of them.