---
title: "Windsurf"
description: "Register Unitpost as an MCP server in Windsurf (Cascade)."
url: https://www.unitpost.com/guides/mcp/windsurf
section: MCP
updated: 2026-07-24
---
# Windsurf

## Connection settings

- **Server URL**: https://mcp.unitpost.com/mcp
- **Transport**: Streamable HTTP
- **Auth header**: Authorization: Bearer pk_live_YOUR_KEY (production key from www.unitpost.com)
- **Tools**: one per API operation (emails_send, campaigns_send, …)

## Windsurf

> Register Unitpost as an MCP server in Windsurf (Cascade).

Paste one JSON block into Windsurf's MCP config and refresh.

### 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. Open MCP settings

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

### 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. Refresh and verify

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

### 5. Send a test

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

## Related

- [Generic / custom client](https://www.unitpost.com/guides/mcp/custom): Connect any MCP-compatible client or your own agent to Unitpost.
- [Cursor](https://www.unitpost.com/guides/mcp/cursor): Add Unitpost as an MCP server in Cursor so the agent can send + manage email.
- [Claude Code](https://www.unitpost.com/guides/mcp/claude-code): Add Unitpost to Claude Code with a single `claude mcp add` command.