---
title: "Windsurf"
description: "Connect Windsurf (Cascade) to Unitpost — OAuth in the browser, or a key block."
url: https://www.unitpost.com/guides/mcp/windsurf
section: MCP
updated: 2026-08-28
---
# Windsurf

## Connection settings

- **Server URL**: https://mcp.unitpost.com/mcp
- **Transport**: Streamable HTTP
- **Auth (recommended)**: OAuth 2.1 — add the URL, approve in the browser (scopes match API capabilities; tokens refresh automatically)
- **Auth (legacy)**: Authorization: Bearer pk_live_YOUR_KEY (workspace API key from Settings → API keys; for clients that can only paste a key)
- **Tools**: one per API operation (email_send, email_campaigns_send, …)

## Windsurf

> Connect Windsurf (Cascade) to Unitpost — OAuth in the browser, or a key block.

Prefer the OAuth browser approval. If your setup needs static config, paste the key block instead.

### 1. Connect with OAuth (recommended)

In Windsurf: Settings → Cascade → MCP Servers → Add Server, or paste this into `~/.codeium/windsurf/mcp_config.json`. Windsurf uses `serverUrl` (not `url`) for remote HTTP. No key to copy. Your client opens Unitpost in the browser — pick a workspace, approve the scopes, and you're connected. Tokens refresh automatically.

```json
{
  "mcpServers": {
    "unitpost": {
      "serverUrl": "https://mcp.unitpost.com/mcp"
    }
  }
}
```

### 2. Refresh and verify

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

### 3. Send a test

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

## Related

- [OpenCode](https://www.unitpost.com/guides/mcp/opencode): Connect OpenCode with OAuth — add the remote URL, approve in the browser.
- [Grok](https://www.unitpost.com/guides/mcp/grok): Point Grok at the Unitpost MCP URL. Marketplace listing is a separate catalog PR.
- [Generic / custom client](https://www.unitpost.com/guides/mcp/custom): Connect any MCP-compatible client or your own agent to Unitpost.