Skip to main content
Codex supports remote MCP servers natively over HTTP.

​
Add the server

This writes a [mcp_servers.contenthero] block to ~/.codex/config.toml. You can also add it by hand:

​
Authorize

This opens the OAuth consent page in your browser. Sign in with your ContentHero account and approve. Codex stores and refreshes the token, so you authorize once. No API key needed.

​
Verify

Start Codex and ask it to read your ContentHero balance. It calls get_balance and returns your credits.
Native remote MCP needs a current Codex CLI. If codex mcp add --url or codex mcp login is not recognized, update Codex. As a fallback for older builds, bridge over stdio: set the server command to npx with args ["-y", "mcp-remote", "https://mcp.contenthero.ai"].