---
title: "Cursor"
description: "Connect Cursor to Unitpost with OAuth — approve in the browser, or a key block."
url: https://www.unitpost.com/guides/mcp/cursor
section: MCP
updated: 2026-08-28
---
# Cursor

## 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, …)

## Cursor

> Connect Cursor to Unitpost with OAuth — approve in the browser, or a key block.

Add the server URL and approve in the browser (Cursor handles OAuth itself, including reconnect). Static key config still works as a fallback.

### 1. Connect with OAuth (recommended)

Add a remote server with the URL below — Cursor opens Unitpost in the browser to approve. No key to copy. Your client opens Unitpost in the browser — pick a workspace, approve the scopes, and you're connected. Tokens refresh automatically. If Cursor ever signs you out, the Authenticate button re-runs the same approval (a 401 from us triggers its reconnect).

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

> Prefer this over pasting secrets. To pin credentials instead, add an `auth` object with `CLIENT_ID: cursor-oauth` (public client, PKCE — no secret needed).

### 2. Reload and verify

Reload MCP servers in Cursor. unitpost should show connected with tools like `email_send`, `email_campaigns_send`, `email_domains_verify`.

### 3. Send a test

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

## Related

- [Claude Code](https://www.unitpost.com/guides/mcp/claude-code): Connect Claude Code to Unitpost with OAuth — add the URL, authenticate from /mcp, approve in the browser.
- [Claude Desktop](https://www.unitpost.com/guides/mcp/claude-desktop): Connect with OAuth via Add custom connector — approve in the browser. API-key bridge as fallback.
- [Codex](https://www.unitpost.com/guides/mcp/codex): Connect ChatGPT/Codex with OAuth in the browser. Codex CLI takes a static key instead.