Codex Setup

Connect Massive to Codex with the remote MCP server

Massive's remote MCP server connects Codex to live U.S. market data: dividends, trades, quotes, options chains, and the rest of our catalog. It queries our REST API under the hood, so Codex can pull data and verify response shapes while building against it.

This guide walks through adding the remote server to Codex and authenticating over OAuth. There is nothing to install. Setup takes about two minutes and requires the Codex CLI plus a Massive account.

What You Can Do

Once connected, Codex can:

  • Pull live market data while it writes code, like the latest trade or quote for a ticker.
  • Inspect the real response shape of an endpoint before building against it.
  • Confirm a field name exists instead of guessing, avoiding hallucinated keys.
  • Discover which Massive endpoint returns the data shape you need for a use case.

Because the server makes the calls itself, Codex can check real responses as it works, which keeps generated integrations accurate.

Setup

Two steps. Allow about two minutes start to finish.

1. Install Codex

If you don't have it, install the OpenAI Codex CLI and confirm it works:

codex --version

2. Add the Massive Remote MCP Server

Add Massive to your Codex config at ~/.codex/config.toml:

Then authenticate over OAuth:

codex mcp login massive

This opens your browser to sign in to your Massive account and stores the credentials, refreshing them automatically. There is no API key to copy or store. A free Basic account is enough to start.

Note: Remote (streamable-HTTP) MCP servers are first-class in current Codex. On older versions that only pick up stdio servers, add a [features] block with experimental_use_rmcp_client = true above the server entry, or upgrade Codex. You can also register the server in one step with codex mcp add massive --url https://mcp.massive.com/.

Your MCP access mirrors your Massive entitlements. You can query any asset class your plan includes. If you have Stocks access, stocks data is available through MCP. Requesting data you are not entitled to (for example, Options without an Options plan) returns an access-denied error.

Test the Integration

Now that the connection is live, put it through its paces. A few prompts to start with:

  • "Show me the latest trade for AAPL." (Trades)
  • "Is the U.S. market open right now?" (Market Status)
  • "When is the next market holiday?" (Market Holidays)
  • "What dividends has AAPL paid this year?" (Dividends)
  • "Give me a snapshot of today's biggest gainers." (Snapshots)

When you're ready to go deeper, hand Codex a full brief and let it chain several calls together:

Pull all dividends declared in the last 30 days, filter to U.S. equities with a market cap over $50 billion, rank them by yield, and summarize the top five with their pay dates.

Codex will search for the right endpoints, make the live calls, and stitch the results into a single answer.

Troubleshooting

Massive doesn't appear in Codex's tools. Confirm the entry in ~/.codex/config.toml parses cleanly and restart Codex. On older Codex versions, remote servers are ignored unless experimental_use_rmcp_client is enabled (see Setup).

Authentication didn't complete. Run codex mcp login massive again and finish the browser sign-in.

Codex answers without calling Massive. It's drawing on training data. Prompt it explicitly to "use the Massive MCP server" before the question.

Access-denied errors. You're querying an asset class your plan doesn't include. Check your entitlements in the Dashboard.

Did you find this page helpful?
Do you still need help with something?