Windsurf

What are the connection details?

How do I connect Windsurf?

1. 1

   Create a production API key

   Open https://www.unitpost.com → Settings → API keys → create a scoped key. Copy the full pk_live_… value (shown once). In every snippet below, replace pk_live_YOUR_KEY with that value.

   Must be production. Keys from unitpost.dev only work on the dev API. This MCP URL is production (mcp.unitpost.com) — a .dev key returns 401 Invalid API key on tool calls even if the server appears connected.

2. 2

   Open MCP settings

   In Windsurf: Settings → Cascade → MCP Servers → Add Server, or edit `~/.codeium/windsurf/mcp_config.json`.

3. 3

   Paste this server block

   Replace pk_live_YOUR_KEY — keep Bearer .

   JSON

   {
     "mcpServers": {
       "unitpost": {
         "serverUrl": "https://mcp.unitpost.com/mcp",
         "headers": {
           "Authorization": "Bearer pk_live_YOUR_KEY"
         }
       }
     }
   }

   Grant only the scopes the agent needs (e.g. emails:send for emails_send). Prefer a revocable key dedicated to the agent.

4. 4

   Refresh and verify

   Refresh the MCP server list. Unitpost's tools should appear under unitpost.

5. 5

   Send a test

   Ask Cascade to send a test email from a verified domain, then confirm in Unitpost Activity.