Use Figurewell MCP with OpenAI Codex CLI

Point-in-time SEC financials API + MCP: XBRL as first reported, EDGAR times. 100 free/day.

Remote MCP server (Streamable HTTP), nothing to install. Free: 100 free/day · Paid: $5 for 1,500 calls; keys from $19/mo

Set it up

Open ~/.codex/config.toml (create it if needed).
Add the [mcp_servers] table shown and save.
Start Codex; the server's tools are available to the agent.
Ask a question the tools can answer.

Add to ~/.codex/config.toml:

[mcp_servers.figurewell-api]
url = "https://figurewell-api.cybermaxtools.com/mcp?via=use-with-codex"

With a paid key:

[mcp_servers.figurewell-api]
url = "https://figurewell-api.cybermaxtools.com/mcp?via=use-with-codex"
env_http_headers = { "x-api-key" = "CYBERMAX_API_KEY" }

env_http_headers maps the header to an environment variable name, so the key stays in your environment.

Where it goes:

~/.codex/config.toml (or .codex/config.toml in a trusted project)

Config format checked 2026-10-09 against OpenAI Codex CLI's MCP documentation.

Tools you get

Endpoint checked 2026-10-09: https://figurewell-api.cybermaxtools.com/mcp answered an MCP initialize (protocol 2025-06-18) and tools/list with 3 tools, all marked read-only. No key was used and no tool was called.

Tool	What it does	Required inputs
`financials_as_of`	A company's 10-K/10-Q/20-F/40-F filings (newest accepted first, up to 40) with revenue, profit, EPS, cash, debt, cash flow and margins as each filing first reported them, EDGAR acceptance time and filing link. as_of = only filings accepted by then.	none
`snapshot_as_of`	For up to 10 tickers, the newest filing EDGAR had accepted by as_of, with key metrics as first reported.	none
`metric_history`	One metric per period, newest first: value as first reported (and when), latest value known at as_of, restated flag.	none

Test the endpoint from a terminal

This lists the tools without a key and without calling any of them:

curl -s https://figurewell-api.cybermaxtools.com/mcp \
  -H 'content-type: application/json' \
  -H 'accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

If it does not work

Each server is its own [mcp_servers.<name>] table; keep the name to letters, digits, dashes and underscores.
For a fixed header value instead of an environment variable, Codex also documents http_headers.
The free tier has a daily limit (see the pricing line above); a paid key raises it.

Figurewell in other clients

Cursor VS Code (GitHub Copilot)Claude Code Claude Desktop and claude.ai Windsurf (Devin Desktop)Cline Gemini CLI

More MCP servers for OpenAI Codex CLI

All Figurewell setups · All OpenAI Codex CLI setups · All