Windsurf

Prerequisites

• Windsurf installed
• A MailCraft API key with the scopes you want the agent to have — create one under Settings → API keys.

Setup

1. 1

   Open the MCP configuration file

   Edit ~/.codeium/windsurf/mcp_config.json (or open Cascade → MCP servers → View raw config) and add:

   ~/.codeium/windsurf/mcp_config.json Copy

   {
     "mcpServers": {
       "mailcraft": {
         "serverUrl": "https://mcp.mailcraft.host",
         "headers": {
           "Authorization": "Bearer sk_live_your_api_key"
         }
       }
     }
   }

   Replace sk_live_your_api_key with your key. The agent only gets the tools that key's scopes allow. Windsurf uses "serverUrl" for remote servers, not "url".

2. 2

   Restart Windsurf

   Restart Windsurf, or press refresh in Cascade’s MCP panel, to load the configuration.

3. 3

   Verify the connection

   Open Cascade and ask:

   cascade Copy

   List all my MailCraft domains

Example prompts

Once connected, try asking Windsurf:

• Create a domain for mail.example.com and show me the DNS records to add
• Show me my ten newest contacts
• Is [email protected] worth sending to?

See every tool the agent can use in the MCP server reference.