Unitpost/Guides

Codex

Paste a short TOML block into `~/.codex/config.toml`, restart Codex, done.

What are the connection details?

Server URLhttps://mcp.unitpost.com/mcp
TransportStreamable HTTP
Auth headerAuthorization: Bearer pk_live_YOUR_KEY(production key from www.unitpost.com)
Toolsone per API operation (emails_send, campaigns_send, …)

How do I connect Codex?

  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 Codex config

    Edit `~/.codex/config.toml` (create the file if it does not exist).

  3. Paste this TOML

    Replace pk_live_YOUR_KEY — keep Bearer inside the quotes.

    TOML
    [mcp_servers.unitpost]
url = "https://mcp.unitpost.com/mcp"

[mcp_servers.unitpost.http_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. Restart and verify

    Restart Codex so it reloads the config. unitpost tools should be available to the agent.

  5. Send a test

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