Connect MerchantFlow to Windsurf

Windsurf is Codeium's agentic IDE. Its Cascade AI supports MCP out of the box. Setup is identical in spirit to Cursor.

Prerequisites

• Windsurf v1.2 or newer
• MerchantFlow Pro tier subscription

Step 1: Copy the config

From Settings → MCP Server, click Install in Windsurf and copy the config.

Step 2: Paste into the Windsurf MCP config

Open ~/.codeium/windsurf/mcp_config.json (create it if it doesn't exist) and paste:

{
  "mcpServers": {
    "merchantflow": {
      "serverUrl": "https://mcp.merchantflow.ai/mcp"
    }
  }
}

Step 3: Restart Windsurf

Fully quit and reopen Windsurf so Cascade picks up the new MCP server.

Step 4: Authorize

On the first tool call, Windsurf opens your browser to the MerchantFlow consent page. Click Allow access to issue a tenant-scoped token.

Step 5: Try a prompt

In the Cascade panel:

Which products have good margins but I'm not spending enough on ads for?

Cascade will combine get_top_products and get_ad_performance to answer.

Add the Skill file as a Windsurf rule

Download https://mcp.merchantflow.ai/api/mcp/skill?format=windsurf and save it as .windsurfrules in your workspace root. Cascade will read it automatically.