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
Estrelas
412
Ferramentas
—
Disponibilidade
—
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.
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo Trading Skills?
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Trading Skills precisa de uma chave de API?
Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte Trading Skills usa?
Trading Skills roda localmente via stdio.
Quando Trading Skills foi verificado pela última vez?
Última verificação: 2026-11-17. Claude powered advisor system for option traders