Unitpost/Guides

OpenCode

OpenCode auto-detects OAuth on 401 (DCR). Add a remote server and run `opencode mcp auth unitpost`.

What are the connection details?

Server URLhttps://mcp.unitpost.com/mcp
TransportStreamable 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)
Toolsone per API operation (email_send, email_campaigns_send, …)

How do I connect OpenCode?

  1. Add the remote server

    Put this in ~/.config/opencode/opencode.jsonc (or project opencode.json). No key to copy. Your client opens Unitpost in the browser — pick a workspace, approve the scopes, and you're connected. Tokens refresh automatically.

    JSON
    {
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "unitpost": {
      "type": "remote",
      "url": "https://mcp.unitpost.com/mcp",
      "oauth": {}
    }
  }
}

  2. Authenticate

    Restart OpenCode, then run opencode mcp auth unitpost (or wait for the first tool call). Complete the browser approval.

  3. Verify

    Run opencode mcp list. unitpost should show connected.

  4. Send a test

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

No browser on this machine? For headless setups, CI, SSH, or clients that can only paste a key, use the API-key setup instead.