Windsurf MCP server for WhatsApp and Instagram DMs.
Add the InstantReply block to mcp_config.json and Cascade can answer post comments, manage keyword rules, and switch AI replies on or off per channel. Free is read-only. Paid plans can write.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"instantreply": {
"command": "npx",
"args": [
"-y",
"@instantreply.co/mcp"
]
}
}
}No key needed to start. Ask Windsurf to connect InstantReply and approve the code in your browser.
Set up Windsurf
Install the InstantReply server in Windsurf
Config paths for Windsurf come from Codeium's public docs and can change between releases. If a step does not match your version, check the Windsurf MCP docs.
- 01
Edit the config
Add the instantreply entry to ~/.codeium/windsurf/mcp_config.json (on Windows, the same path under your user profile). Create the file if it does not exist.
- 02
Reload the server list
Restart Windsurf, or refresh the MCP list in Cascade's settings. InstantReply should appear with its tools.
- 03
Connect your workspace
In Cascade type: Connect InstantReply. It calls start_setup and shows a link and a code. Approve in the browser, then reload the server so every tool loads.
Config options
mcp_config.json
{
"mcpServers": {
"instantreply": {
"command": "npx",
"args": [
"-y",
"@instantreply.co/mcp"
]
}
}
}With an API key
{
"mcpServers": {
"instantreply": {
"command": "npx",
"args": [
"-y",
"@instantreply.co/mcp"
],
"env": {
"INSTANTREPLY_API_KEY": "ir_live_YOUR_KEY_HERE"
}
}
}
}What is specific to Windsurf
- The config path is ~/.codeium/windsurf/mcp_config.json and it uses the same mcpServers shape as the other npx clients.
- Windsurf limits how many MCP tools Cascade can load at once. This server exposes 60, so check Windsurf's current limit and switch off tools you do not need.
- create_keyword_automation takes effect immediately. If you want an owner to approve a rule first, ask Barq to propose it instead.
- reply_to_comment posts publicly under the comment, not as a DM, and needs the messages:send scope.
What you can ask
Three workflows in Windsurf
- 01
Reply to comments on a post
Ask Cascade for the comments that have no reply yet, read the thread context, and draft a public answer. It posts only after you confirm, and the reply shows under the original comment.
list_commentsget_commentreply_to_comment - 02
Build a keyword rule with a safety check
Have Cascade list the existing keyword automations first so it does not duplicate one. Then it creates a rule that replies, escalates, assigns, or adds a tag when a message matches.
list_keyword_automationscreate_keyword_automation - 03
Pause AI replies on one account while you test
List your connected channels, pick one integration_id, and turn AI DM replies off for it. The other channels keep running. Turn it back on when the test is done.
list_channelsset_channel_ai_replies
What the server exposes
60 tools and 11 prompts, gated by plan
Free workspaces get read-only access. Creator does not include MCP. The MCP plans (MCP Starter, MCP Growth and MCP Pro) are built for bringing your own agent and model: they include the MCP tools but no InstantReply-hosted AI replies. Starter, Growth, Pro, and the three Developer plans include the full tool set. WhatsApp automation needs Growth or Pro, or the 7-day Pro trial that every new workspace starts with. See pricing for the plan table.
- Conversations and messages (7)
list_conversationsget_conversationlist_messagessend_messagereact_to_messageassign_conversationclose_conversation- Contacts (3)
list_contactsget_contactupdate_contact- Channels and per-channel AI (13)
list_channelslist_channel_groupsconnect_channelcreate_channel_groupupdate_channel_groupassign_channel_grouplist_channel_group_knowledgeadd_channel_group_knowledgedelete_channel_group_knowledgelist_channel_ai_providersset_channel_ai_providerdelete_channel_ai_providerset_channel_ai_replies- Comments and keyword automations (11)
list_keyword_automationscreate_keyword_automationupdate_keyword_automationdelete_keyword_automationlist_commentsget_commentreply_to_commentset_channel_comment_ai_repliesset_comment_ai_repliesget_comment_automation_settingsset_comment_keyword_rules- WhatsApp templates and journeys (13)
list_templatesget_templatevalidate_template_draftvalidate_templatesubmit_templatesubmit_stored_templatedelete_templatesend_whatsapp_templatetrigger_journeyvalidate_journey_triggercheck_journey_statuslist_journey_historytrigger_journey_batch- Analytics, limits, and diagnostics (7)
get_analytics_summaryget_usageget_developer_capabilitiesget_developer_onboardingget_developer_limitsrecommend_planexplain_delivery_failure- Barq and approvals (5)
ask_barqpropose_knowledge_entrypropose_follow_up_rulelist_pending_approvalsdecide_approval
Last verified: October 2, 2026, against the MCP server source and the plan table.
Windsurf MCP questions
Where is the Windsurf MCP config file?
It is ~/.codeium/windsurf/mcp_config.json on macOS and Linux, and the same path under your user profile on Windows. Windsurf may also offer a settings screen for MCP servers. Check its docs if the file location changes.
Is there a limit on how many tools Cascade can use?
Windsurf caps the number of MCP tools Cascade can load at once, and the exact number has changed over time. InstantReply exposes 60 tools, so check the current limit in Windsurf's docs and disable the tool groups you do not use.
Will Cascade reply to a comment without asking?
reply_to_comment posts a public reply as soon as it runs, so keep Windsurf's tool approval on for it. It needs the messages:send scope, which Free keys do not have.
Can Cascade change my AI auto-reply settings?
Yes. set_channel_ai_replies turns DM auto-replies on or off for one connected channel, and set_channel_comment_ai_replies does the same for comments on one page. Both are write tools, so they need a paid plan.
More: MCP overview, developer quickstart, API reference, MCP inbox guide, WhatsApp API Python tutorial.
Use a different tool?
Pick yours.
7-day Pro trial · no credit card
Give Windsurf an inbox to work with.
Connect Instagram, WhatsApp, and Messenger, then let Windsurf read threads and draft replies while you work. Writes need a paid plan.