Skip to content
Terminal

Codex CLI

Published . Updated .

Codex can read your alerts and propose changes through Terminal's MCP server. MCP (Model Context Protocol) lets an AI assistant call tools on a server you choose. Read MCP for the tools and what they cost.

The address is https://terminal.tokensmarketcap.com/mcp. Use this address. Sign-in works only on this host.

Add the server

Codex reads MCP servers from ~/.codex/config.toml. Add a terminal table:

[mcp_servers.terminal]
url = "https://terminal.tokensmarketcap.com/mcp"

Sign in

Then sign in:

codex mcp login terminal

Your browser opens Terminal. Sign in to Terminal first if it asks.

Terminal's page asks whether to allow the app to use your Terminal account, and lists what it may do. "Read alerts, rules and receipts" is always on. "Create and change alerts" lets Codex propose changes for you to confirm. "Subscribe to services on the exchange" shows only if the exchange is open to your account. It starts unticked, because it spends credits. Untick anything you do not want, then press Allow.

Terminal's server follows the sign-in rules of the MCP specification. We have tested sign-in from Claude Code. We have not tested it from Codex yet. If sign-in does not finish, use an API key.

With an API key

Create a key at API keys. Tick "Create and change alerts" when you create it if Codex should propose changes. Every plan includes a key. Then send the key on the Authorization: Bearer header:

[mcp_servers.terminal]
url = "https://terminal.tokensmarketcap.com/mcp"
bearer_token_env_var = "TERMINAL_API_KEY"

Codex reads the key from the environment variable TERMINAL_API_KEY, so the key itself stays out of the file. Set the variable before you start Codex. Do not put the key in the address. Each tool call counts as one API call for the key. Read Authentication for scopes and caps.

What the tools do

Terminal does not place trades, and neither do these tools.

What to ask

Stop access

Open the API keys page in Settings. Under Connected apps, revoke Codex. If you connected with a key, revoke the key on the same page. Then remove the terminal entry from the file you added it to.

Where these steps come from

The file name, the table name, the address field, the variable field and the login command are from OpenAI's Codex documentation, Model Context Protocol, read on November 12, 2026. OpenAI can change them. If a step here does not match what you see, follow OpenAI's page.

Create a free account

All developer pages

Terminal reports market events for conditions you set. It does not tell you to buy, sell, or hold, and it does not place trades.