Listed from the MCP registry; nobody on Odel publishes it.
Self-hosted options trading terminal: positions and Greeks, risk, paper trading, news, journal
Runs on your machine from its package; the steps are below.

At most: creates or changes data: records, files, settings.
Odel charges nothing per call. The publisher may charge for its own service.
Runs locally over stdio
This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).
Run
uvx zeus-options-terminal
MCP client config
{
"mcpServers": {
"zeus-terminal": {
"command": "uvx",
"args": [
"zeus-options-terminal"
]
}
}
}Run
docker run -i --rm ghcr.io/jackson-cmd/zeus-options-terminal:0.7.1
MCP client config
{
"mcpServers": {
"zeus-terminal": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/jackson-cmd/zeus-options-terminal:0.7.1"
]
}
}
}Everything an options trader keeps ten browser tabs open for, in one terminal.
Live positions & Greeks · P/L and risk · exit discipline · paper trading with option and stock legs · a four-source news desk · stock picker · earnings & SEC filings · an honest trade journal. Connect tastytrade, Alpaca or Public, or upload a CSV from any broker. It runs entirely on your own computer, in 中文 / 双语 / English.
🌐 Website · 中文说明 → README_zh.md · 🚀 Quick start · What's new · All features · User manual · Contributing
The trades in the tour are made up; quotes, news and charts are real data from the day it was recorded.
git clone https://github.com/jackson-cmd/zeus-options-terminal
cd zeus-options-terminal
./start.sh # macOS / Linux (Windows: double-click start.bat)
The first run installs everything into a local virtual environment (Python 3.10+) and opens http://localhost:8765. Then:
Port 8765 taken? Run PORT=8790 ./start.sh. Where each broker's keys come from: Connect your broker.
One command and no clone. pipx puts ZEUS in an environment of its own (Python 3.10+):
pipx install zeus-options-terminal
zeus # opens http://localhost:8765 (zeus --port 8790 for another port)
Settings and data stay in ~/.zeus-terminal, so pipx upgrade zeus-options-terminal keeps them. pip install zeus-options-terminal inside a virtual environment works too. More in manual §1.8.
No Python needed. The image is on GitHub Packages for Intel and AMD (amd64) and for ARM (arm64, such as Apple silicon and Raspberry Pi):
docker run -d --name zeus --restart unless-stopped \
-p 127.0.0.1:8765:8765 -v zeus-data:/data \
ghcr.io/jackson-cmd/zeus-options-terminal:latest
Then open http://localhost:8765. Your settings, trades and caches stay in the zeus-data volume. To update, run docker pull ghcr.io/jackson-cmd/zeus-options-terminal:latest and docker rm -f zeus, then the same docker run; nothing is lost. Keep 127.0.0.1: in -p: ZEUS has no login, so its port must stay on your own computer. Your time zone, AI agents, a Compose file and what the image leaves out: manual §1.7.
If you were looking for a self-hosted options trading dashboard, an options profit calculator with live Greeks, a tastytrade, Alpaca or Public portfolio tracker, an options trading journal, a paper-trading simulator for spreads, a stock screener with support and resistance, or a bilingual US stock market news desk: it is all here, in one app.
Latest release 0.7.1 (2026-11-13). The full history is in the changelog.
| New in 0.7.x, 0.6.0, 0.5.x, 0.4.x, 0.3.x and 0.2.x | |
|---|---|
🤖 In the official MCP Registry: AI clients that install MCP servers from the registry can find ZEUS as io.github.jackson-cmd/zeus-options-terminal and start it themselves with uvx zeus-options-terminal, or from the Docker image. Connect an agent → | |
📦 pip and pipx: pipx install zeus-options-terminal, then zeus, installs and starts ZEUS without cloning the code; pipx upgrade keeps your settings and trades. Install with pipx → | |
🐳 Run with Docker: one docker run starts ZEUS from GitHub Packages on Intel, AMD and ARM. Your settings and trades stay in a volume, the port stays on your own computer, and AI agents connect through docker exec. How to run it → | |
| 🔌 Alpaca and Public: connect an Alpaca account (free, paper trading included) or a Public account for live positions, fills, working orders and quotes with Greeks. Positions and quotes are separate choices, so you can also keep your uploaded trades and take quotes from Alpaca. ZEUS only reads; it never places an order. Connect a broker → | |
| 🧪 Sample portfolio: on a fresh install, one click loads six positions and a closed trade priced with today's real option quotes, so you can try every page before connecting anything. One click removes it. How to start → | |
| ❓ Help on every page: a small ? beside the columns, scores and cards opens a plain explanation of what the item is, how it is calculated and how to use it, and the ? in the top bar lists every button and number on the page. How it works → | |
| 🔌 Plug in your own AI agents (MCP): Claude Code, Claude Desktop, GPT through Codex, Gemini CLI or an agent you build can read your positions, run the pre-trade checkup, price spreads, and read the news and your journal. If you allow it, they can also paper trade. ZEUS is a local MCP server, so no API key is needed. Connect an agent → | |
| 🟩 Heatmap: the picker's heatmap is back, one click away from the K-line chart wall. How to use it → | |
| 🧪 Paper Trade: build any strategy on the live option chain with option and stock legs, save it as a simulated trade and follow its P/L. How to use it → | |
| 📧 E-mail alerts: every desktop alert can also arrive in your inbox, on macOS and on Linux. How to set it up → | |
| 🔄 Sector rotation: 80 industry groups ranked by momentum and trend, and 🎲 options sentiment works out of the box. How to use it → | |
| ∞ Exact max profit and loss: short puts and stock are measured down to zero, and unlimited strategies show ∞. How it is calculated → | |
| 🌐 English everywhere: the TA screener and single-ticker page now follow 中文 / 双语 / English. Languages → | |
| 📚 A complete user manual and a feature checklist, in English and Chinese, with clickable contents. Open the manual → |
I built ZEUS Terminal for myself over about six months, on and off, and I have traded with it every day for more than a year.
It started as a P/L viewer for my tastytrade spreads. It grew, one real trading problem at a time, into a complete options trading terminal that I run on my own machine: every position priced live with Greeks and probabilities, exit rules that catch me before I make the same mistake twice, a news desk that reads Benzinga, Finviz, The Wall Street Journal and MarketWatch in two languages, a stock picker built on charts I actually look at, earnings and SEC filings in one place, and a trade journal that tells me the truth about my own trading.
I have lived inside this tool through rallies, crashes and earnings seasons, and I have fixed almost every bug I ran into. Now I am handing it over. Nothing of mine is inside — no accounts, no trades, no keys. You bring your own; they stay on your computer.
Free wherever possible. Most of what traders usually pay for, such as option quotes, a news terminal, a screener and journal software, runs here locally for free: option data from Cboe's delayed feed, news from Finviz, WSJ and MarketWatch, and your trades from a plain CSV. A tastytrade or Benzinga account makes it smoother, but neither is required.
Beyond automation, play the game yourself. Trading agents are automating more and more of trading. Alongside them, you can still step in and play the game yourself: think about what the other players are doing and what the price has already absorbed, then make your own call. After more than a year with this tool, my strongest lesson is that decision discipline and risk control matter more than finding the next great setup: when to take profit, when to admit a mistake, how much one position may lose. Much of ZEUS exists for exactly that, from the exit rules and the pre-trade checkup to the stress tests and the trade journal.
Why ZEUS? Options are priced by the Greeks — Delta, Gamma, Theta, Vega — and Zeus is the king of the Greek gods. This terminal is where you rule them.
![]() Positions — every strategy with live P/L, max profit/loss, chance of profit and DTE | ![]() Strategy detail — P/L across prices and dates, Greeks, chance of profit |
![]() Picker — the K-line chart wall with support/resistance and EMA 50/200 | ![]() Trade journal — win rate, profit factor, monthly targets, equity curve |
All trades and positions in the screenshots are made up (free manual mode); quotes, news and SEC filings are live public data from the day they were taken. Every view is in 📸 Screenshots.
| tastytrade API — the smoothest | Alpaca — free, with a paper account | Public | Free mode — no broker account | |
|---|---|---|---|---|
| Positions | Pulled live from your account | Pulled live from your paper or live account | Pulled live from your account | Upload a CSV or type trades in (stocks and options) |
| Quotes | Real-time DXLink streaming, sub-second | Free data: IEX stock prices in real time; options at Alpaca's indicative prices with Greeks and IV | Real-time quotes, option chains and Greeks | Options from Cboe delayed quotes (free, ~15 min delayed; after the close they keep the closing bid/ask, IV and Greeks), stocks from Yahoo Finance, automatically switching to Finviz when Yahoo rate-limits |
| Fills, expirations, assignments | Booked automatically | Read from your fills | Read from your history | Replayed FIFO from your fills; expired options settle at intrinsic value |
| Trade journal | Syncs every hour by itself | Rebuilt from your fills every hour | Rebuilt from your history every hour | Rebuilt instantly from your uploads |
| Buying power, live orders, missing take-profit orders | ✅ | ✅ | ✅ | — |
| Everything else (picker, digest, events, journal analytics, AI…) | ✅ | ✅ | ✅ | ✅ |
If you have a tastytrade account, connect it. The whole terminal was designed around that feed and it shows: streaming P/L that moves with every tick, real fills, nothing to maintain. Alpaca is the free way to get a live account feed, paper trading included, and Public works for Public customers. ZEUS only reads from them and never places an order. Free mode is there so that anyone, with any broker, can still use it. Positions and quotes are two separate choices in Settings: you can, say, keep uploading your trades and take quotes from Alpaca.
Just looking? On the empty Positions page press Load the sample: six positions and one closed trade, priced with that moment's real option quotes, so every page has something to show. One click removes it.
Benzinga is optional too. With a Benzinga Pro login you get the live Benzinga wire, pre-market commentary, market events and real-time signals. Without it, the Digest runs on the free bilingual wire: Finviz + WSJ + MarketWatch.
This tour covers the highlights. ZEUS does far more than fits on one page: the complete feature checklist lists every page, button, alert and background job, and the user manual explains how to use every one of them, with clickable contents.
/pretrade-checkup): trend → touch of support/resistance → IV & earnings → macro calendar. It exists to create friction on purpose. The 🩺 button on Positions adds a checkup panel: correlation with what you hold, concentration, a mirror of your past mistakes, spread suggestions and a liquidity scan./ta/./ta/ page), so the percentiles need a few weeks of history.yt-dlp).Use whichever you have: Claude Code CLI (your Claude subscription), an Anthropic API key, or any OpenAI-compatible endpoint (OpenAI, DeepSeek, OpenRouter, a local Ollama…). With nothing configured, ZEUS simply runs without the AI buttons.
It works the other way round too: ZEUS is an MCP server. Point Claude Code, Claude Desktop, Codex (GPT), Gemini CLI or your own agent at http://127.0.0.1:8765/mcp. It gets 18 tools backed by ZEUS's own numbers: positions with exact max profit and loss, breakevens, Greeks and exit advice, what-if pricing of any strategy, the four-gate checkup, liquidity, news, events, sector rotation and your journal. Then ask something like "which of my positions should I take profit on, and what earnings land before they expire?" It is read-only unless you let agents paper trade, it answers only programs on this computer, and it never touches a real order. It is also in the official MCP Registry as io.github.jackson-cmd/zeus-options-terminal, so clients that install servers from there can start it with uvx zeus-options-terminal. Connect an agent →
Made-up demo trades in free (manual) mode; quotes, news and filings are live public data.
![]() Positions — live P/L, breakeven distance, max profit / loss, chance of profit, progress | ![]() Strategy detail — P/L table across prices and dates, Greeks |
![]() Risk analysis — stress test, VaR / CVaR, beta-weighted Greeks for the whole book | ![]() Pre-trade checkup — spread suggestions ranked by liquidity and reward / risk |
![]() Picker — K-line chart wall with support / resistance and EMA 50/200 | ![]() AI picker — trend and dip candidates with strikes and ready-to-paste orders, works without AI too |
![]() Paper trades — simulated option and stock trades with total, today's and realized P/L | ![]() Paper trade builder — a covered call (100 shares + a short call): exact max profit and loss, P/L by price and date |
![]() Single-ticker page — chart, Finviz technicals and fundamentals, news | ![]() Digest — Finviz, WSJ and MarketWatch, plus Benzinga with a login |
![]() Market chart — SPY / QQQ full-history candles | ![]() Calendar — earnings and high-impact macro dates |
![]() SEC filings reader — 10-K / 10-Q / 8-K straight from EDGAR | ![]() Risk radar — today's news risk and a 30-day landmine calendar |
![]() Trade journal — win rate, profit factor, monthly targets, equity curve | ![]() Journal analysis — what works and what doesn't, from your own trades |
![]() Settings — everything is entered in the browser; saved secrets are write-only | ![]() AI agents (MCP) — connect Claude, GPT (Codex), Gemini or your own agent; no API key |
Everything is set in the browser, in ⚙ Settings → Broker & data: one block per broker, each with a Test connection button. Positions and quotes are separate choices, and anything a broker does not carry comes from the free sources. ZEUS only reads; it never places an order.
my.tastytrade.com → Manage → API Access → OAuth Applications → create an application (keep the client secret) → Manage → Create Grant (all scopes) → copy the refresh token. Paste both into Settings and press Test connection.
Alpaca: sign up at alpaca.markets (free) → your Paper Trading account → API Keys → Generate → copy the key ID (starts with PK) and the secret. For a live account, generate them there (AK…) and set Alpaca paper account to off. Public: public.com → Account → Settings → API → generate a secret key. Step by step in the manual.
| Setting | Unlocks | Free? |
|---|---|---|
| tastytrade OAuth (client secret + refresh token) | Live positions, streaming quotes, automatic journal, buying power, working orders | free with a tastytrade account |
| Alpaca key ID + secret | Live positions from your paper or live account, fills, working orders; free IEX stock prices and indicative option quotes with Greeks | ✅ free account and data |
| Public secret key | Live positions, history, working orders, real-time quotes, option chains and Greeks | free with a Public account |
| Positions come from / Quotes come from | Pick the account source and the quote source separately; anything a broker lacks comes from the free sources | ✅ |
| Manual trades (CSV / form) | Positions, P/L, journal and analytics without any broker connection | ✅ |
| Benzinga Pro cookies | Benzinga live digest, pre-market, market events, history | Benzinga Pro subscription |
| Benzinga data API key | Real-time signals feed, scanner | from your Benzinga Pro session |
| Finviz Elite token | Finviz news through the official export (otherwise the free page) | optional |
| AI provider | AI summaries, market brief, AI picker, AI journal review, position review | your own |
| Barchart login | Barchart screener and signal lists | Barchart account |
| E-mail (SMTP) | Every alert also by e-mail, with a test button (macOS and Linux) | ✅ |
| AI agents (MCP) | Your own agents (Claude, GPT through Codex, Gemini…) use ZEUS as tools; on by default, paper trading by agents off | ✅ |
Download the template from Settings (or use examples/trades_template.csv):
date,symbol,asset,side,effect,qty,price,fees,option_type,strike,expiration,multiplier,order_id,note
2026-03-02 10:15,AAPL,stock,buy,open,50,231.40,0,,,,,,long stock
2026-03-03 11:02,NVDA,option,buy,open,1,12.50,1.10,C,180,2026-04-17,100,nvda-bcs-1,bull call spread long leg
2026-03-03 11:02,NVDA,option,sell,open,1,6.20,1.10,C,190,2026-04-17,100,nvda-bcs-1,bull call spread short leg
side: buy / sell — or broker shorthand BTO, STO, BTC, STC, "Buy to Open", "Sell to Close"…effect: open / close / (blank = decided automatically).AAPL 260618C00200000), compact (AAPL260618C200) or broker text (AAPL 06/18/2026 200.00 C).order_id (or the same minute) are shown as one strategy.~/.zeus-terminal/ (permission 600), never inside the repository — a git push cannot leak them.~/.zeus-terminal/runtime/. The runtime folders inside the code are links to that place and are ignored by git.git push, or build a zip with tools/export_clean_zip.sh; both contain code only. Do not drag the whole folder into a website or zip it by hand. tools/install_git_hook.sh adds a local pre-commit check that refuses links, data files, anything shaped like a key or token, and your own home path, login name or git identity.docker exec), and no MCP tool can place a real order or read a saved key. What an agent reads goes to that agent's model provider.Host headers (DNS rebinding), only accepts cross-origin calls from localhost, and write endpoints need a header that other websites cannot send./data volume, and the documented command publishes the port on 127.0.0.1 only. The localhost checks work exactly as they do without Docker.Where things are:
zeus-options-terminal/
├── zeus/ all the code
│ ├── options_analyzer/ the server (optionstrat_server.py), positions, checkup, paper trade, page assets
│ ├── heatmap/ · ta_screener/ · ai_picks/ · stock_selector/ · barchart/ picker and screeners
│ ├── benzinga_digest/ · news_radar/ · market_brief/ · sec_filings/ … news, brief, events
│ ├── trade_journal/ · journal_review/ · journal_expiry_whatif/ the journal
│ ├── zeus_*.py · local_broker.py settings, brokers (Alpaca, Public), AI, news, MCP, e-mail
│ ├── Dockerfile the container image on ghcr.io (and Dockerfile.dockerignore)
│ └── defaults/ ticker lists seeded on the first start
├── docs/ user manual, feature list, screenshots, README images
├── site/ the project website (GitHub Pages)
├── tests/ offline tests: python -m pytest
├── tools/ privacy pre-commit hook, clean zip export, release notes, checks of the Docker image and the pip package
├── examples/ CSV template for manual trades
├── .github/ CI and release workflows, issue forms, CONTRIBUTING, security policy, code of conduct
├── server.json · glama.json · CITATION.cff entries for the MCP Registry, Glama and Zenodo
└── start.sh · start.command · start.bat · requirements.txt · pyproject.toml
How the pieces talk to each other (paths below are inside zeus/):
browser (PWA, 中文 / 双语 / English)
│ WebSocket + REST
▼
FastAPI server ── options_analyzer/optionstrat_server.py
├─ broker ........ tastytrade REST + DXLink stream │ local_broker.py (manual mode, Cboe + Yahoo)
│ │ zeus_brokers.py (Alpaca · Public, read-only)
├─ news .......... Benzinga (cookies / WS) │ zeus_news.py (Finviz · WSJ · MarketWatch)
├─ picker ........ heatmap/ · ta_screener/ · ai_picks/ · stock_selector/ · barchart/
├─ brief ......... market_brief/ · narratives/
├─ events ........ sec_filings/ · benzinga_market_events/ · trade_journal/calendar_events.py
├─ journal ....... trade_journal/ · journal_review/ · journal_expiry_whatif/
├─ discipline .... options_analyzer/checkup/ · pre_trade_checkup/ · sr_alert/
├─ paper trade ... options_analyzer/paper_trade.py · paper_trade_routes.py (simulated, never sent to a broker)
├─ AI ............ zeus_ai.py (Claude CLI · Anthropic · OpenAI-compatible)
└─ settings ...... zeus_config.py → ~/.zeus-terminal/config.json
Runtime data (candles, caches, digests) lives in ~/.zeus-terminal/runtime/; folders such as zeus/data/ inside the code are only links to it. Configuration can also come from environment variables (ZEUS_<KEY>, e.g. ZEUS_TT_REFRESH_TOKEN) and the settings folder can be moved with ZEUS_HOME.
Do I need tastytrade? No. Alpaca (free, with a paper account) and Public connect too, and free mode covers stocks and options from any broker through a CSV. tastytrade is simply the smoothest.
Can I try it without any account? Yes: press Load the sample on the Positions page. The picker, digest, events and TA screener run on free data anyway.
Do I need Benzinga? No. The Digest runs on Finviz + WSJ + MarketWatch for free.
Does it place orders? Not real ones. It only reads from tastytrade, Alpaca and Public. The 🧪 Paper Trade tab records simulated trades for practice; real trades happen in your broker.
Does it work on Windows / Linux? The core does. Desktop notifications are macOS only; on Linux, set up e-mail alerts instead.
Can I run it in Docker? Yes: Run with Docker. The image runs on Intel, AMD and ARM. Desktop notifications are not in it; e-mail alerts are.
Where are my settings? ~/.zeus-terminal/config.json (in Docker, the zeus-data volume). Delete the folder to forget everything.
First launch after the close and the picker shows 0 quotes? Press Refresh on the picker; the last session's closing prices fill in within seconds.
ZEUS has far more features than this page can show, and it keeps growing; new features may be added over time. Pull requests are welcome: a bug fix, a new data source or broker, a translation, better docs, or one of the parts not wired up yet. Read CONTRIBUTING.md first. Every pull request runs the test suite on Linux, macOS and Windows, and main only accepts pull requests whose checks pass.
Questions and ideas go to Discussions, bugs to Issues, and security problems to a private report (SECURITY.md). Everyone here follows the code of conduct.
ZEUS Terminal is released under the PolyForm Noncommercial License 1.0.0.
Rights holders: if you believe anything in this repository infringes your rights (trademarks, data, terms of service or anything else), open an issue and the material will be removed promptly.
Disclaimer. This is a personal tool shared as is, without any warranty. It is not investment advice. Options involve substantial risk of loss. You are responsible for your own trades and for complying with the terms of every data provider and broker you connect. ZEUS Terminal is not affiliated with or endorsed by tastytrade, Alpaca, Public, Benzinga, Cboe, Finviz, Dow Jones / The Wall Street Journal / MarketWatch, Barchart, Yahoo or Anthropic; all names belong to their owners.