Home / AI agents / Windsurf
MCP

Schedule social media posts with Windsurf

Add Postozo to Windsurf's MCP config. Then ask its agent to write and schedule posts from your project.

Works in: the Windsurf editor (its docs now call the app Devin Desktop). Connects with: an API key header. Setup steps follow Windsurf's own docs, checked on 29 September 2026.

How to connect Postozo to Windsurf

You need a Postozo account with at least 1 connected channel. Windsurf connects to Postozo's MCP server at https://app.postozo.com/mcp using an API key header.

  1. In Postozo, open Settings, Developers and copy your API key. It starts with pz_live_. Treat it like a password.
  2. In the agent panel, open the ... menu and choose Open MCP config file. This opens mcp_config.json. The current docs place it at ~/.config/devin/mcp_config.json on macOS and Linux and %APPDATA%\devin\mcp_config.json on Windows.
  3. Add Postozo:
{
  "mcpServers": {
    "postozo": {
      "serverUrl": "https://app.postozo.com/mcp",
      "headers": { "Authorization": "Bearer ${env:POSTOZO_API_KEY}" }
    }
  }
}
  1. Set POSTOZO_API_KEY in your environment and save the file. Restart the app if the server does not appear. Then ask: "List my Postozo channels".

Windsurf's MCP documentation now lives on docs.devin.ai. It supports OAuth for remote servers too. On Enterprise plans an admin must turn MCP on, and Teams can limit which servers are allowed.

Check it works

Ask the agent: "List my Postozo channels."

What Windsurf can do with Postozo

Postozo gives Windsurf 20 tools. A normal flow is: list your channels, read the rules of each network, check the post, find a free slot, then schedule it once you say yes.

ToolWhat it doesChanges data
list_channelsList the connected social channels (accounts, pages) with their id, network, name and status. Call this first to get channel ids.No
list_networksList every network this server supports and whether it can be connected. Useful to explain what is possible.No
list_customersList customers. A customer groups channels (agencies use 1 per client).No
get_channel_rulesGet the posting rules for 1 channel: max length, media needs, whether comments are supported, and the settings schema (some settings are required, for example a title on YouTube or a board on Pinterest). Read before scheduling to that channel.No
find_free_slotFind the next free posting time for these channels, using each channel's preferred posting times.No
check_postCheck a post against every channel's rules without saving it. Returns a list of problems (empty means it is fine).No
schedule_postCreate or edit a post for 1 or more channels. Supports drafts, scheduling, posting now, client review, threads with delays, per-channel text, network settings, tags and repeats. Returns the post id, its status and a preview link.Yes
list_postsList posts on the calendar between 2 dates (default: last 7 days to next 30 days).No
get_postGet 1 post with its text per channel, state per channel (queued, published, error...), links to the live posts, errors with a fix, comments and history.No
change_post_dateMove a post to a new date and time.Yes
retry_postRetry the channels of a post that failed or could not be confirmed. Only use after the user confirms the post is not already live.Yes
delete_postDelete a post from the calendar. Posts already live on a network stay live there.Yes
upload_media_from_urlImport an image or video from a public URL into the media library. Returns a media id to use in schedule_post.Yes
list_mediaList files in the media library.No
list_tagsList tags used to label posts.No
get_analyticsGet account statistics for 1 channel from its network (7, 30 or 90 days). Some networks do not share statistics.No
get_post_analyticsGet statistics for 1 published post on 1 channel. Use the per-channel post id from get_post (channels[].root.id).No
get_workspace_statsCounts from this workspace: posts by state, published posts per channel, and short link clicks.No
run_channel_toolRun a network helper for 1 channel, for example list Pinterest boards, Reddit flairs or YouTube playlists, to fill a setting. get_channel_rules lists the tools for each channel.No
generate_imageCreate an image with AI from a description and save it to the media library. Uses 1 image credit. Returns a media id. Only when AI images are turned on for your workspace.Yes

The server also offers 2 ready prompts: plan_week (plan 5 posts for the next 7 days about a topic) and repurpose (turn a link or text into 1 post per channel).

Example prompts

  • "Summarise this week's merged pull requests as a LinkedIn post and save it as a draft."
  • "Write a Mastodon and Bluesky post about the new release, each within its limit."
  • "Schedule the draft for tomorrow at a free time."
  • "Which of my channels need to be reconnected?"
  • "Check this post against every channel's rules."
  • "Show me what is on the calendar for the next 7 days."

Safety and control

  • 14 of the 20 tools only read. The 6 that change data (schedule_post, change_post_date, retry_post, delete_post, upload_media_from_url and generate_image) are marked as write tools, so Windsurf can ask you before it runs them.
  • The server tells the AI to confirm the text, channels and time with you before it schedules or publishes.
  • Ask for drafts ("save as drafts") or for client review ("send for approval") when you want a human to check first.
  • A post is never sent twice. If Postozo cannot confirm a post went live, it marks it "could not confirm" instead of retrying on its own.
  • Remove access any time in Postozo under Settings, Approved Apps, or by creating a new API key.

Sources

Setup steps checked on 29 September 2026 against: docs.devin.ai/desktop/cascade/mcp. Windsurf is a trademark of its owner. Postozo is not affiliated with it. Menus change; if a step looks different, follow the linked docs.

FAQ

Questions

Can Windsurf schedule posts with Postozo?

Yes. After you add Postozo's MCP server, Windsurf can list your channels, check each network's rules, find free times and create drafts, scheduled posts or posts for client approval.

Is it serverUrl or url?

Windsurf's docs accept serverUrl or url for remote servers. The example uses serverUrl.

My older Windsurf install uses a different path. What now?

Use the Open MCP config file menu. It always opens the file your version reads.

Can I use OAuth instead of a key?

Windsurf's docs say OAuth is supported for remote servers. We document the key header because it needs no extra steps.

Does it cost extra?

No. The API and MCP server are included in every Postozo plan. Windsurf has its own plans and limits.

Connect Windsurf to Postozo

Start a 7-day free trial, connect your channels, then add the server.

Create your free account