ArtBreguez/greeks-mcp

A Model Context Protocol server that exposes the
**Greeks options-analytics API** as tools for any MCP client —
**Claude Desktop**, **Cursor**, Claude Code, and more. Ask your assistant for GEX,
Greeks, Max Pain, unusual flow or a full dashboard on any ticker and it pulls live
from the API.
Only **derived/computed analytics** are exposed — no raw market data is
redistributed.
Quickstart
**1. Get an API key.** Sign up at greeks.pro and create a key
— it looks like grk_ . Public tools (screener, health, plans) work without
one.
**2. Add one block to your client config** and restart the client:
That's it — the assistant now has all 17 tools. uv
downloads and runs the published package on demand in an isolated environment, so
there's nothing to install or keep updated by hand.
Prefer pipx? pipx install greeks-mcp, then use "command": "greeks-mcp" with no
args.
Docker
A Dockerfile is included for containerized runs. The server speaks stdio (what
MCP clients spawn), so run it interactively (-i):
The image starts and answers MCP introspection (initialize + tools/list) with
no key; GREEKS_API_KEY is only needed for the authenticated analytics tools.
To wire the container into an MCP client, set "command": "docker" with
"args": ["run","--rm","-i","-e","GREEKS_API_KEY","greeks-mcp"].
Where the config block goes
The same mcpServers block works in every MCP client — only the file location
differs.
| Client | Config file |
|---|---|
| Claude Desktop (macOS) | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Desktop (Windows) | %APPDATA%\Claude\claude_desktop_config.json |
| Cursor (global) | ~/.cursor/mcp.json |
| Cursor (per-project) | /.cursor/mcp.json |
Ready-to-copy configs live in examples/. After reloading, the server
shows up under Cursor's Settings → *MCP* with a green dot and its 17 tools; type
@greeks-analytics in chat (or just ask for GEX/greeks/max pain) to use them.
Tools
| Tool | Endpoint | Min plan | What it returns |
|---|---|---|---|
| get_max_pain | /api/analytics/maxpain | Free | Max Pain strike per expiration |
| get_greeks | /api/analytics/greeks | Trader | Δ Γ Θ V ρ, theo price, mispricing per contract |
| get_gex | /api/analytics/gex | Trader | GEX/DEX per strike, total Net GEX, Gamma Flip |
| get_flow | /api/analytics/flow | Trader | Unusual-activity signals |
| get_vol_structure | /api/analytics/vol-structure | Trader | IV skew + term structure with plain-English reads |
| get_overview | /api/analytics/overview | Pro | Full dashboard (sentiment, GEX, max pain, expected move, IV surface, term structure, top flow) |
| get_vex | /api/analytics/vex | Pro | Vanna & Charm exposure (2nd-order dealer Greeks) |
| get_zero_dte | /api/analytics/zero-dte | Pro | 0DTE focus panel — pin risk, gamma flip, max pain |
| get_gex_intraday | /api/analytics/gex-intraday | Pro | Intraday gamma-regime time-series + flip timing |
| get_track_record_detail | /api/analytics/track-record | Pro | Day-by-day level outcomes (the receipts behind the %) |
| get_snapshot | /api/analytics/snapshot | — | Compact analytics snapshot |