Most retail traders juggle 5+ tabs — broker, charting platform, screener, news feed, spreadsheet — just to decide whether to enter a trade. This project collapses all of that into a single conversational interface powered by Claude.
Ask a question in plain English, get back real data: technicals, fundamentals, option Greeks, risk metrics, earnings dates, correlation matrices, and full PDF reports. Connect your Interactive Brokers account and it manages your portfolio too — finds roll candidates for expiring shorts, flags earnings risk, and generates action reports.
Claude powered advisor system for option traders
星數
412
工具
—
可用率
—
Who is this for?
Retail options traders who sell premium, run PMCCs, or manage covered calls
Self-directed investors who want quick fundamental + technical scans without switching tools
Python-literate traders who want to extend the analysis with custom scripts
IBRK users who want AI-assisted portfolio management
Quick example — scan for bullish setups and check PMCC viability:
You: Scan AAPL,MSFT,NVDA,GOOGL,AMZN for bullish trends, then check the top picks for PMCC suitability
Claude: [runs scanner-bullish → filters top scores → runs scanner-pmcc]
NVDA: Bullish score 8/10, PMCC score 9.2/11 — LEAPS $95 call (Δ0.82),
sell $140 call (Δ0.18), net debit $5,420, annual yield 47%...
Another example — correlation check before adding to a portfolio:
You: Show correlation for SPY,GOOG,NVDA,ZM,RTX,PFE,XOM
Claude: NVDA is the standout diversifier — near-zero correlation with everything.
RTX/XOM at 0.86 — little diversification benefit between them.
Real sessions in Claude Desktop (free account)
"Analyze option spread strategies and probability of profit for SPY, QQQ and DIA"
Optional: TWS or IB Gateway for portfolio features
Two Ways to Use
Claude Code / Cursor (Full Experience)
Installation
git clone https://github.com/staskh/trading_skills.git
cd trading_skills
uv sync
Run Claude Code or Cursor in the repository root. All skills are available as interactive commands — ask questions about your IBKR portfolio, symbols, or companies of interest.
MCP Server (Claude Desktop)
The MCP server is a lightweight alternative for use with Claude Desktop (including the free tier). It exposes 23 trading analysis tools directly to Claude Desktop without needing Claude Code.
The script will be trading-skills-mcp.exe in that directory (typically at C:\Users\<YourUsername>\AppData\Local\Programs\Python\Python<Version>\Scripts\)
Open Claude Desktop, go to Settings → Developer → Edit Config:
† MCP-only helper — not a standalone skill. Used in Claude Desktop to discover available expiry dates before calling ib_option_chain.
Sandbox Outputs (Not Committed)
Temporary reports, datasets, and notebooks are saved to sandbox/ and are not committed to git. Report filenames include timestamps: <name>_YYYY-MM-DD_HHmm.<ext>.
The env block is merged with the system environment, so other variables are not affected.
Development
# Run tests
uv run pytest tests/ -v
# Lint
uv run ruff check src/ tests/
uv run ruff format src/ tests/
# Test individual script
uv run python .claude/skills/fundamentals/scripts/fundamentals.py AAPL
# Debug MCP server with MCP Inspector
npx @modelcontextprotocol/inspector uv run python -m mcp_server.server
Architecture
User Query → Claude Code/Desktop → Skill or MCP Tool → Python Script → Response
Skills are SKILL.md files in .claude/skills/ that instruct Claude how to fetch and analyze data using Python scripts. Skill scripts live under .claude/skills/<skill-name>/scripts/, and progressive reference material belongs in .claude/skills/<skill-name>/references/.
The MCP server (mcp_server/server.py) wraps the same Python scripts as tools for Claude Desktop via the FastMCP framework.