■ OpenAI · MCP clientQuickstart · 2 min

Codex CLI × Hail

Codex has a first-class `codex mcp` command family. Run two commands. The CLI, the VS Code extension, and Codex cloud then share the Hail toolset.

Codex CLICodex IDE ExtensionCodex Cloud

Setup

~60 seconds · no API key

01

Drop Hail into your config

Add the Hail MCP server using the snippet below. Paste it where this client expects MCP servers. The path varies, the shape doesn't.

codex mcp add + codex mcp login

SHELL · Terminal

codex mcp add hail --url https://mcp.hail.so
codex mcp login hail

02

Click Allow. Then try it.

Reload the client. On first use it pops a browser tab. Sign in to Hail, or sign up in 30 seconds. Click Allow and tokens flow back to the client. Then send the prompt below. If a call is placed, an SMS lands, or an email shows up in the inbox view, you're done.

"Use hail to text me when the test suite goes green."

■ Notes

Two stepsadd writes the config. login opens the browser consent.

Config file[mcp_servers.hail] with url = https://mcp.hail.so in ~/.codex/config.toml.

Old buildsUpgrade Codex. Do not set experimental_use_rmcp_client.

Shared configCLI, IDE extension, and cloud share it. Check with codex mcp list.

URLNo trailing slash. Audience checks are exact-string.

PrivacyChat history never reaches Hail. Only tool arguments do.

ManageRevoke or manage this app at hail.so/console/apps.

Self-hostSet HAIL_API_KEY as the bearer. See docs/setup/mcp.