OpenAI Codex

Add Papertrade AI to the OpenAI Codex CLI and IDE extension as a remote MCP server with OAuth, or run it locally over stdio.

Codex supports remote MCP servers with OAuth in the CLI and the IDE extension. Both share ~/.codex/config.toml.

Remote server (recommended)#

codex mcp add papertrade --url https://papertrade-ai.ninabrekkerese.workers.dev/mcp
codex mcp login papertrade

codex mcp login opens the Papertrade AI connect page in your browser. Choose Read only or Trade with guardrails and sign with your wallet.

The resulting config.toml entry:

[mcp_servers.papertrade]
url = "https://papertrade-ai.ninabrekkerese.workers.dev/mcp"

Local stdio server#

npx -y papertrade-ai login
codex mcp add papertrade -- npx -y papertrade-ai

Or by hand:

[mcp_servers.papertrade]
command = "npx"
args = ["-y", "papertrade-ai"]

For read-only access without logging in, add env = { PAPERTRADE_WALLET = "0xYourWallet" }.

Using it#

Run /mcp in Codex to confirm the server and its 18 tools are loaded, then ask:

• "Pull the BTC 1h chart from Papertrade and summarize the trend."
• "Write a script that logs the Papertrade leaderboard every hour" (Codex can read the REST API docs).
• "Preview a $20 ETH long at 300x."

Codex asks for approval before running tools that are annotated as destructive (open_position, close_positions).