---
title: "Cursor"
description: "Add Unitpost as an MCP server in Cursor so the agent can send + manage email."
url: https://www.unitpost.com/guides/mcp/cursor
section: MCP
updated: 2026-07-24
---
# Cursor

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

## Cursor

> Add Unitpost as an MCP server in Cursor so the agent can send + manage email.

Paste one JSON block into Cursor's MCP config, reload, and the agent gets Unitpost tools.

### 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 the MCP config file

Edit `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project only). Or: Cursor Settings → MCP → Add new MCP server.

### 3. Paste this server block

Put the `unitpost` entry under top-level `mcpServers`. Replace `pk_live_YOUR_KEY` with your key — keep the `Bearer ` prefix and the space.

```json
{
  "mcpServers": {
    "unitpost": {
      "url": "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. Reload and verify

Reload MCP servers in Cursor. unitpost should show green with tools like `emails_send`, `campaigns_send`, `domains_verify`.

### 5. 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): Add Unitpost to Claude Code with a single `claude mcp add` command.
- [Claude Desktop](https://www.unitpost.com/guides/mcp/claude-desktop): Connect via the mcp-remote bridge in claude_desktop_config.json (API-key auth).
- [Codex](https://www.unitpost.com/guides/mcp/codex): Add the Unitpost MCP server to OpenAI Codex CLI.
