Windsurf + Zaprep

Manage Instagram automations from Windsurf Cascade

Add Zaprep to mcp_config.json and Cascade can create, audit and export your Instagram and Facebook automations right next to your code.

mcp_config.json setupOAuth sign-inWorks with Cascade
WindsurfZaprep connected

Copy my three automations from @brand.main to @brand.shop.

✓ list_accounts✓ duplicate_automation

Duplicated FREEBIE, LINK and PRICE onto @brand.shop.

They are paused so you can check the messages before going live. Turn them on?

Example conversation. Real tool names.

Coding agent setup

How do I connect Zaprep to Windsurf?

Windsurf editor with Cascade. On Teams and Enterprise, an admin may need to allow the server.

Server URL
https://www.zaprep.com/api/mcp
Sign-in
OAuth, or a Zaprep API key for scripts
Cost
Included on every Zaprep plan, Free included
New automations
Saved paused until you turn them on
Platforms
Instagram and Facebook Pages
Revoke
Settings, then AI tools in Zaprep

Zaprep MCP server URL

https://www.zaprep.com/api/mcp
  1. 1

    Open MCP settings

    In Windsurf, open Settings, then Tools, then Windsurf Settings, and choose Add Server. Or edit ~/.codeium/windsurf/mcp_config.json.

  2. 2

    Add Zaprep

    Paste the snippet below and save, then refresh the MCP list.

  3. 3

    Sign in

    Windsurf opens Zaprep in your browser. Log in and approve access.

  4. 4

    Ask Cascade

    Cascade can now call the Zaprep tools.

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "zaprep": {
      "serverUrl": "https://www.zaprep.com/api/mcp"
    }
  }
}

Need an API key? Create one in Zaprep. Official Windsurf docs: Windsurf MCP docs.

Try these

What can you ask Windsurf?

Copy a prompt, paste it into Windsurf, and adjust the keyword or link.

Clone setup

“Copy every automation from one account to another, paused.”

Usage

“How many DMs have I used this month and what is my limit?”

AI ideas

“Suggest automations for my last 10 posts that do not have one yet.”

Export

“Export contacts as CSV.”

40+ tools

What can Windsurf do with Zaprep?

Everything you do in the Zaprep dashboard, except billing, is available as an MCP tool.

Create automations

Comment-to-DM, DM keyword, story reply and follow-gated flows, from a post link or a plain description. Saved paused until you turn them on.

create_automationresolve_postduplicate_automation

Read the numbers

DMs sent, link clicks, followers gained and the full funnel for every automation.

get_analyticsget_automation_metricsget_automation_funnel

Fix what broke

Find out why a rule skipped, then pause, edit or switch it back on.

troubleshoot_automationget_automation_activitytoggle_automation

Get AI suggestions

Turn captions into ready-to-approve keyword automations, one post or all of them.

suggest_automationbulk_suggest_automationsanalyze_post

Work your leads

List and export everyone who shared an email or messaged you.

list_contactsexport_contacts_csv

Run the rest

Scheduled automations, short links, link in bio, media kit and AI replies.

create_scheduled_automationcreate_linkupdate_link_in_bio

Best for: Builders using Windsurf who want marketing ops in the same agent.

See every tool · What it can set up on Instagram

Sign-in

OAuth or API key?

Windsurf supports both. OAuth is quicker on your own machine.

OAuth WindsurfAPI key Windsurf
SetupPaste the URL, sign in to ZaprepCreate a key in Settings, then API keys
Best forChat apps and editors on your own machineCLIs, CI, servers and workflow tools
Credentials storedShort-lived tokens, refreshed automaticallyOne zap_ key you keep secret
RevokeDisconnect it in Settings, then AI toolsDelete it in Settings, then API keys

Limits

What Windsurf cannot do in Zaprep

  • Send DMs or comment replies outside your automations. The AI sets up rules; Zaprep sends through Meta’s official APIs.
  • Turn on a new automation it created unless you, or the AI after you confirm, switch it on.
  • Touch billing, payments or your plan.
  • Connect, reconnect or remove your Instagram and Facebook accounts.
  • Read your Instagram password. Accounts are connected with Meta login, and the AI signs in to Zaprep, not Instagram.

Channels

Which platforms can Windsurf automate?

One connection covers every account in your Zaprep workspace.

Windsurf + Zaprep FAQ

Save mcp_config.json, then press refresh in Cascade’s MCP panel and check that the JSON is valid. If sign-in fails, remove the entry, restart Windsurf and add it again.

Yes. Add "headers": { "Authorization": "Bearer zap_..." } next to serverUrl. Create the key in Zaprep under Settings, then API keys.

Windsurf caps how many MCP tools can be active at once. If you hit it, turn off Zaprep tools you do not need in the MCP panel.

Yes. Zaprep runs its own remote MCP server at https://www.zaprep.com/api/mcp. No Zapier or other middleman is involved.

Yes. MCP access is included on every Zaprep plan, Free included. Your plan’s usual limits on automations and DMs still apply.

To run automations, yes: connect an Instagram professional account or a Facebook Page in Zaprep first. Without one the AI can only read your Zaprep settings.

Instagram professional accounts and Facebook Pages today. TikTok and YouTube are coming next.

New automations an AI creates are saved paused, so nothing sends until you or the AI turns it on after you confirm. Edits to an automation that is already on apply right away, and most AI apps ask before running a change. You can disconnect any AI app in Zaprep under Settings, then AI tools.

Yes. Once connected, the AI can list and export the contacts your automations collected, including emails. Only connect AI apps you trust, and disconnect any you stop using.

Open Settings, then AI tools in Zaprep and choose Disconnect next to the app. It is signed out right away. For an API key, delete it under Settings, then API keys.

Last updated . Menu names in other apps change often; the official docs link above has the latest.

Let Windsurf run your DM automations

Free plan, no card. Connect Instagram or a Facebook Page, then add Zaprep to your AI tool.