---
title: "Gemini CLI"
description: "Register Unitpost as an MCP server for the Gemini CLI."
url: https://www.unitpost.com/guides/mcp/gemini
section: MCP
updated: 2026-07-24
---
# Gemini CLI

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

## Gemini CLI

> Register Unitpost as an MCP server for the Gemini CLI.

Paste one JSON block into Gemini settings, restart, run `/mcp`.

### 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 Gemini settings

Edit `~/.gemini/settings.json` (user-level) or `.gemini/settings.json` (project).

### 3. Paste this server block

Under `mcpServers`, add `unitpost`. Replace `pk_live_YOUR_KEY` — keep `Bearer `.

```json
{
  "mcpServers": {
    "unitpost": {
      "httpUrl": "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. Verify

Restart the Gemini CLI and run `/mcp`. unitpost should list its tools.

### 5. Send a test

Ask Gemini to send an email from a verified domain and confirm it in Unitpost Activity.

## Related

- [Windsurf](https://www.unitpost.com/guides/mcp/windsurf): Register Unitpost as an MCP server in Windsurf (Cascade).
- [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.