Requirements
- OpenAI Codex CLI installed
- An active Extole user account
- An OpenAI API key
Setup
Choose your authentication method. See the MCP authentication guide if you’re not sure which to use.Option 1: OAuth (Recommended)
Step 1: Add the Extole MCP server~/.codex/config.toml
Step 2: Authenticate
~/.codex/config.json
Your browser will open to an Extole authorization page. Review the permissions and click Authorize.
Step 3: Verify
<YOUR_API_KEY>
The Extole server should show as connected.
Option 2: API Key
Step 1: Get your API key Generate one at the My.Extole Security Center. Step 2: Edit your Codex config Add the following to~/.codex/config.toml:
codex --list-tools
Or in JSON format (~/.codex/config.json):
codex --list-tools
Replace <YOUR_API_KEY> with your Extole API key.
Step 3: Verify
Bearer
Using the MCP
Once connected, Extole tools are available in any Codex session:“Pull the conversion report for my refer-a-friend program for the past 30 days.”
“What reward suppliers are configured on my account?”
“Update the friend reward in campaign X to $15.”Run
codex --list-tools to see which Extole tools are available.
Write operations — Actions that modify programs, rewards, or campaign components execute immediately under your Extole permissions and are recorded in the Extole change log.
Troubleshooting
“Tool not found” — Confirm the URL is correct. Runcodex --list-tools to see what’s being discovered.
“Unauthorized” — Check your token. Verify the Bearer prefix is present.
Note: Codex CLI MCP support is evolving. Refer to the Codex CLI documentation for the latest configuration format if these steps differ from your version.