Windsurf Setup

Connect Windsurf to Keplars in under two minutes using the MCP Server. Send emails and manage contacts from inside your editor.

Windsurf supports MCP servers natively in Cascade mode. Once configured, you can send emails, manage audiences, and trigger campaigns without leaving your editor.

Setup

Get your Keplars API keys

Open the Keplars dashboard and navigate to API Keys in your workspace settings. You need two keys:

Send key (prefixed live_): used for sending emails
Admin key (prefixed adm_): used for templates, contacts, campaigns, and domains

Create both and copy them. You will only see each key once.

Install mcp-remote

npm install -g mcp-remote

Enable MCP in Windsurf settings

Open Windsurf Settings and navigate to AI Features. Make sure MCP is enabled.

Open the MCP config

~/.codeium/windsurf/mcp_config.json

If the file does not exist, create it at that path.

Press Win + R, paste the path below, and press Enter:

%USERPROFILE%\.codeium\windsurf\mcp_config.json

This expands to C:\Users\<your-username>\.codeium\windsurf\mcp_config.json. If the file does not exist, create it at that path.

Add the Keplars server

{
  "mcpServers": {
    "keplars": {
      "command": "mcp-remote",
      "args": [
        "https://mcp.keplars.com/mcp",
        "--header",
        "Authorization:<YOUR_SEND_KEY>",
        "--header",
        "X-Admin-Api-Key:<YOUR_ADMIN_KEY>"
      ]
    }
  }
}

If you already have other MCP servers in the config, add keplars alongside them inside mcpServers.

Restart Windsurf

Close and reopen Windsurf. The Keplars tools load on startup.

Verify the connection

Open Cascade and click the tools icon. You should see the Keplars tools listed, including send_transactional_email, list_audiences, and the rest.

Try it out

Once connected, ask Cascade naturally:

Send a transactional email

"Send a transactional email to [email protected] with subject 'Deployment complete' and body 'Your app was deployed successfully'"

List templates and send one

"List my Keplars templates, then send the welcome template to [email protected] with first_name set to Sarah"

Create and send a campaign

"Create a Keplars campaign called 'Release Notes' targeting audience aud-123 using template tmpl-abc with subject 'What is new in v2.0', then send it"

Campaigns and bulk sends trigger a confirmation step

When you ask Cascade to send a campaign or a bulk email, it will first show you the audience size and ask you to confirm before dispatching. Reply "yes" to proceed or "no" to cancel.

Troubleshooting

Tools not appearing in Cascade

MCP tools only appear in Cascade mode, not in Chat mode. Make sure you have Cascade selected.

Tools not appearing after restart

Check that the JSON in your mcp_config.json is valid. Use jsonlint.com to validate. A trailing comma or missing brace will prevent the config from loading silently.

mcp-remote not found

Run npm install -g mcp-remote and make sure the npm global bin directory is in your PATH. Restart your terminal after installing.

"Unauthorized" error on email sends

Your send key (live_ prefix) may be invalid or deleted. Generate a new one from the Keplars dashboard under API Keys and update the Authorization value in your config.

"Unauthorized" error on templates, contacts, or campaigns

These tools require the admin key (adm_ prefix) in X-Admin-Api-Key. Make sure both headers are present in your config.

Windsurf Setup

On this page