Connect Codex

These steps connect the Codex CLI to your Promoly account. Last tested on October 11, 2026 with Codex CLI 0.161.0.

Connected agents are in an invite-only beta. See Connect an AI coding agent for what an agent can and can't do.

Add the Promoly server

Open ~/.codex/config.toml and add:

[mcp_servers.promoly]
url = "https://api.promo.ly/mcp"

That's all Codex needs. If you set up Promoly earlier with an [mcp_servers.promoly.oauth] section, that setup keeps working.

Sign in

codex mcp login promoly

Your browser opens Promoly. Sign in, choose the account, tick the access you want to allow, and click Allow access. The terminal shows Successfully logged in to MCP server 'promoly'.

Check the connection

Start Codex and paste:

Use the promoly tools to show which Promoly account you're connected to, then list my five most recent campaigns.

Sign out or remove it

codex mcp logout promoly

Then delete the promoly sections from config.toml if you want to remove the server. Signing out on your computer doesn't end the connection on Promoly's side. To do that, disconnect it under Profile → Manage connected apps in the dashboard.

If something goes wrong

• Codex says the promoly tools aren't available after you disconnected or reconnected. Start a new Codex session. A session that was already open when the connection changed doesn't pick up the new sign-in.
• You're on a remote machine over SSH. codex mcp login promoly --no-browser prints the sign-in link. Open it on any computer, then paste the address the browser lands on back into the terminal.

Updated on: 12/10/2026