Skip to main content
Glama
trading-skills

trading-skills

by staskh

Trading Skills — AI-Powered Market Analysis

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.

Star History Chart

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"

Spread analysis with POP metrics for SPY, QQQ, DIA

Requirements

  • Python 3.12+

  • uv package manager

  • Claude Code, Claude Desktop, or Cursor with third-party skills enabled (fully installed and authenticated)

  • Optional: TWS or IB Gateway for portfolio features

Related MCP server: IB Portfolio Tracker MCP Server

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.

Installation

  1. Install the package (requires Python 3.12+):

    pip install trading-skills
  2. Find the full path to the installed command:

    macOS / Linux:

    which trading-skills-mcp

    Windows:

    where trading-skills-mcp

    If where doesn't find it, locate it manually:

    python -c "import sysconfig; print(sysconfig.get_path('scripts'))"

    The script will be trading-skills-mcp.exe in that directory (typically at C:\Users\<YourUsername>\AppData\Local\Programs\Python\Python<Version>\Scripts\)

  3. Open Claude Desktop, go to Settings → Developer → Edit Config:

    Claude Desktop Settings → Developer

    Add the following to claude_desktop_config.json:

    macOS / Linux:

    {
      "mcpServers": {
        "trading-skills": {
          "command": "/full/path/to/trading-skills-mcp"
        }
      }
    }

    Windows:

    {
      "mcpServers": {
        "trading-skills": {
          "command": "C:\\full\\path\\to\\trading-skills-mcp.exe"
        }
      }
    }

    Replace the path with the output from step 2.

  4. Restart Claude Desktop. Don't worry if you see an MCP error message — it will disappear once you try some of the examples below.

Installation from GitHub

Add the following to claude_desktop_config.json:

macOS / Linux:

{
  "mcpServers": {
    "trading-skills": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/staskh/trading_skills.git", "trading-skills-mcp"]
    }
  }
}

Windows:

{
  "mcpServers": {
    "trading-skills": {
      "command": "cmd",
      "args": ["/c", "uvx", "--from", "git+https://github.com/staskh/trading_skills.git", "trading-skills-mcp"]
    }
  }
}

Example Queries

  • "What's AAPL's current price and 1y range?"

  • "Run technical analysis on SPY with RSI/MACD"

  • "Scan AAPL,MSFT,NVDA,GOOGL for bullish trends"

  • "Find PMCC candidates from my watchlist"

  • "Compare risk metrics for MSFT vs AAPL"

  • "Show correlation between SPY,NVDA,GOOG,XOM"

  • "When is NVDA's next earnings?"

  • "Show my portfolio positions" (requires IB)

  • "Generate portfolio action report" (requires IB)

  • "Find roll candidates for my GOOG short call" (requires IB)

Available Skills (25)

Market Data

Skill

Description

stock-quote

Real-time price, volume, change, market cap, 52-week range

option-chain

Calls and puts with strikes, bids, asks, volume, OI, IV

price-history

Historical OHLCV data

fundamentals

Financials, earnings, key metrics, Piotroski F-Score

news-sentiment

Recent headlines and sentiment

earnings-calendar

Upcoming earnings dates with BMO/AMC timing and EPS estimates

calendar

Scheduled US economic events (CPI, NFP, FOMC, GDP...) in ET, with optional ForexFactory cross-check

insider-trading

SEC Form 4 insider transactions — executive buys/sells and sentiment

Analysis

Skill

Description

technical-analysis

RSI, MACD, Bollinger Bands, SMA, EMA, ATR, ADX, correlation matrix

greeks

Delta, gamma, theta, vega, IV (Black-Scholes)

spread-analysis

Verticals, diagonals, straddles, strangles, iron condors

risk-assessment

Volatility, beta, VaR, drawdown, Sharpe ratio

chart-ema-rsi

JPG chart: daily candles, EMA 9/20 with crossovers marked, RSI panel

Scanners

Skill

Description

scanner-bullish

Scan symbols for bullish trends (SMA, RSI, MACD, ADX)

scanner-pmcc

Scan for PMCC suitability (delta, liquidity, spread, IV, yield)

whale-hunting

Detect institutional option whale activity for an underlying (requires Massive API key)

Portfolio (requires TWS/Gateway)

TWS API access levels:

  • Read-only — fetches positions, prices, and Greeks; places no orders: ib-account, ib-portfolio, ib-option-chain, ib-find-short-roll, ib-collar, ib-pmcc-advisor, ib-portfolio-action-report, ib-create-consolidated-report, ib-report-delta-adjusted-notional-exposure

  • Read-write — can place and cancel conditional orders in TWS: ib-stop-loss (only when --execute is passed; dry-run by default)

Skill

Description

ib-account

Account summary (cash, buying power, margin)

ib-portfolio

Portfolio positions with market prices

ib-option-chain

Real-time option chain data from IB (under development)

ib-find-short-roll

Roll candidates for short positions or covered call/put selection

ib-collar

Tactical collar strategy for earnings/event protection

ib-pmcc-advisor

PMCC position analysis: assignment risk, P&L projections, ranked roll candidates

ib-stop-loss

Conditional stop-loss management for PMCC, naked LEAPS, and stock positions

ib-portfolio-action-report

Portfolio review with earnings risk and action items

ib-create-consolidated-report

Consolidate IBRK trade CSVs into summary reports

ib-report-delta-adjusted-notional-exposure

Delta-adjusted notional exposure across accounts

Reports

Skill

Description

report-stock

Comprehensive PDF/markdown report with trend, PMCC, and fundamental analysis

MCP Server Tools (32 tools)

The MCP server exposes skills as tools for Claude Desktop:

TWS API access levels for MCP tools:

  • Read-only: ib_account, ib_portfolio, ib_option_expiries, ib_option_chain, ib_find_short_roll, ib_collar, ib_pmcc_advisor, ib_portfolio_action_report, ib_delta_exposure

  • Read-write (places/cancels orders): ib_stop_loss when execute=True

Category

Tools

Market Data

stock_quote, price_history, news_sentiment, insider_trading, fundamentals, piotroski_score, earnings_calendar, economic_calendar

Technical

technical_indicators, price_correlation, risk_assessment

Options

option_expiries, option_chain, option_greeks

Spreads

spread_vertical, spread_diagonal, spread_straddle, spread_strangle, spread_iron_condor

Scanners

scan_bullish, scan_pmcc

Whale Hunting

whale_hunting

Reports

report_stock

IB Portfolio

ib_account, ib_portfolio, ib_option_expiries†, ib_option_chain, ib_find_short_roll, ib_collar, ib_pmcc_advisor, ib_stop_loss, ib_portfolio_action_report, ib_delta_exposure

† 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>.

Interactive Brokers Setup

To use IB features:

  1. Install TWS or IB Gateway

  2. Enable API connections in TWS: Configure → API → Settings → Enable ActiveX and Socket Clients

  3. Note the port: 7497 (paper) or 7496 (live)

Massive (formerly Polygon.io) Setup

Whale-detection features (option_whales, whales_hunter) require a Massive API key (the platform was previously known as Polygon.io).

Claude Code / Cursor

Create a .env file in the repository root:

MASSIVE_API_KEY=your_polygon_api_key_here

The library loads it automatically via python-dotenv.

MCP Server (Claude Desktop)

Pass the key through the env field in claude_desktop_config.json:

macOS / Linux:

{
  "mcpServers": {
    "trading-skills": {
      "command": "/full/path/to/trading-skills-mcp",
      "env": {
        "MASSIVE_API_KEY": "your_massive_api_key_here"
      }
    }
  }
}

Windows:

{
  "mcpServers": {
    "trading-skills": {
      "command": "C:\\full\\path\\to\\trading-skills-mcp.exe",
      "env": {
        "MASSIVE_API_KEY": "your_massive_api_key_here"
      }
    }
  }
}

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.

Data Sources

Source

Used by

Notes

Yahoo Finance

All market data, fundamental, and options skills

Free; up to 15-minute delay

Massive (formerly Polygon.io)

whale-hunting (whale_hunting MCP tool)

Paid API key required; see setup section below

License

MIT

Available Tools

36 tools
earnings_calendarA

Get upcoming earnings dates with timing (BMO/AMC) and EPS estimates.

Args: symbols: Single symbol or comma-separated list (e.g., 'AAPL' or 'AAPL,MSFT,GOOGL')

Inputs: symbols (required).

economic_calendarA

Get scheduled US economic releases (CPI, NFP, FOMC, GDP, PCE, ISM...) per weekday, in ET.

Events carry impact, actual, consensus and previous. A day with events=null could not be served or verified: verify it manually, never read it as a quiet day.

Args: date: First day, YYYY-MM-DD (default: today ET); a weekend rolls to Monday days: Number of weekdays to report (default 1) impact: 'all' or 'high' (default 'all') forexfactory: Cross-check against ForexFactory and fill Nasdaq's gaps (current Sun-Sat week only; filled events are tagged source='forexfactory')

Inputs: date, days, impact, forexfactory.

fundamentalsA

Get fundamental financial data including metrics, financials, and earnings.

Args: symbol: Ticker symbol data_type: Type of data - 'all', 'info', 'financials', or 'earnings'

Inputs: symbol (required), data_type.

get_versionA

Return the current version of the trading-skills package.

Inputs: no named parameters.

ib_accountA

Get account summary from Interactive Brokers.

Returns cash balance, buying power, net liquidation value, and margin info. Requires TWS or IB Gateway running locally.

Args: port: IB port (7496 for live, 7497 for paper)

Inputs: port.

ib_collarA

Generate tactical collar strategy report for protecting PMCC positions.

Analyzes existing long call (PMCC) positions and recommends put protection through earnings or high-risk events. Requires TWS or IB Gateway running locally.

Args: symbol: Ticker symbol (e.g., AAPL) port: IB port (7496 for live, 7497 for paper) account: Account ID (optional)

Inputs: symbol (required), port, account.

ib_delta_exposureA

Calculate delta-adjusted notional exposure across all IBKR accounts.

Computes option deltas using Black-Scholes and reports long/short exposure by account and underlying symbol. Requires TWS or IB Gateway running locally.

Args: port: IB port (7496 for live, 7497 for paper)

Inputs: port.

ib_find_short_rollA

Find roll, spread, or covered call/put candidates using real-time IB data.

Auto-detects mode based on existing positions:

  • Short option found: roll candidates with credit/debit analysis

  • Long option found: short candidates to create a vertical spread

  • Long stock found: covered call/put candidates Requires TWS or IB Gateway running locally.

Args: symbol: Ticker symbol (e.g., GOOG) port: IB port (7496 for live, 7497 for paper) account: Account ID (optional) strike: Current short strike (optional, auto-detects from portfolio) expiry: Current expiry YYYYMMDD (optional, auto-detects from portfolio) right: 'C' for call or 'P' for put (default: C)

Inputs: symbol (required), port, right, expiry, +2 more.

ib_option_chainA

Get option chain data from Interactive Brokers with real-time quotes.

Returns calls and puts with strikes, bids, asks, volume, and implied volatility. Requires TWS or IB Gateway running locally.

Args: symbol: Ticker symbol expiry: Expiration date (YYYYMMDD) port: IB port (7496 for live, 7497 for paper)

Inputs: expiry (required), symbol (required), port.

ib_option_expiriesA

List available option expiration dates from Interactive Brokers.

Requires TWS or IB Gateway running locally.

Args: symbol: Ticker symbol port: IB port (7496 for live, 7497 for paper)

Inputs: symbol (required), port.

ib_pmcc_advisorA

Analyze PMCC (diagonal call spread) positions and recommend roll actions.

For each spread: reports assignment probability, P&L projections, roll candidates ranked by delta improvement and credit, and a comparison table. Requires TWS or IB Gateway running locally.

Args: port: IB port (7496 for live, 7497 for paper) account: Specific account ID (optional) symbols: Comma-separated symbols to filter (optional, e.g. 'NVDA,WMT') min_roll_dte: Minimum DTE for roll candidates (default 7) price_mode: Option price source — 'mid' (bid+ask)/2 or 'last'

Inputs: port, account, symbols, price_mode, +1 more.

ib_portfolioA

Get portfolio positions from Interactive Brokers.

Returns all positions including stocks and options with market prices. Requires TWS or IB Gateway running locally.

Args: port: IB port (7496 for live, 7497 for paper) account: Specific account ID (optional, uses first if not specified)

Inputs: port, account.

ib_portfolio_action_reportA

Analyze portfolio positions with earnings dates and risk assessment.

Fetches positions, groups into spreads, categorizes by urgency, and returns structured analysis with recommendations. Requires TWS or IB Gateway running locally.

Args: port: IB port (7496 for live, 7497 for paper) account: Specific account ID (optional)

Inputs: port, account.

ib_stop_lossA

Analyze and manage downside stop-loss orders for PMCC, naked LEAPS, and stock positions.

Default mode is dry-run — no orders are placed unless execute=True. Stop price = basis × (1 - stop_pct/100). Basis is max(current_mid, avg_cost) normally; current_mid only when forced=True (can lower existing stops). In execute mode: orphan SL_FALL_ orders are cancelled, then new conditional stop orders are placed. PMCC stops use combo BAG orders (atomic LEAPS + shorts). Requires TWS or IB Gateway running locally.

Args: port: IB port (7496 for live, 7497 for paper) account: Specific account ID (optional) symbols: Comma-separated symbols to filter (optional, e.g. 'NVDA,QQQ') stop_pct: Loss % that triggers exit (default 40) short_near_strike_pct: Alert when spot is within this % of short strike (default 5) price_mode: Option pricing — 'mid' (bid+ask)/2 or 'last' execute: Place conditional stop-loss orders (default False = dry-run) forced: Use current mid as basis, can lower existing stops (requires execute=True)

Inputs: port, forced, account, execute, +4 more.

ib_trades_historyA

Fetch trade executions from Interactive Brokers.

Returns individual trade executions with fills, commissions, and realized P&L, plus aggregated summary by symbol. Uses live API (~7 days history) by default, or FlexReport for full history when token and query ID are provided. Requires TWS or IB Gateway running locally.

Args: port: IB port (7496 for live, 7497 for paper) account: Specific account ID (optional, fetches all if not specified) symbol: Filter trades by symbol (e.g., AAPL) start_date: Start date in YYYY-MM-DD format (default: Jan 1 of current year) end_date: End date in YYYY-MM-DD format (default: today) flex_token: FlexReport token for extended history beyond ~7 days flex_query_id: FlexReport query ID (required with flex_token). Pass a list of IDs to merge and deduplicate results from multiple queries — useful for spans exceeding the FlexReport 365-day per-query limit.

Inputs: port, symbol, account, end_date, +3 more.

ib_trailing_stopA

Manage IB native TRAIL orders for stocks and naked LEAPS positions.

Default mode is dry-run — no orders are placed unless execute=True. PMCC positions are excluded; use ib_stop_loss for those. Requires TWS or IB Gateway running locally.

Args: port: IB port (7496 for live, 7497 for paper) account: Specific account ID (optional) symbols: Comma-separated symbols to filter (optional, e.g. 'JOBY,TSLA') trail_pct: Trail amount as % of reference price (default 20, mutually exclusive with trail_amt) trail_amt: Trail amount in dollars (mutually exclusive with trail_pct) price_mode: Option pricing — 'mid' (bid+ask)/2 or 'last' (LEAPS only) execute: Cancel orphan TS_ orders and place new TRAIL orders (default False = dry-run) forced: Cancel and replace existing TS_ orders with current parameters (requires execute=True)

Inputs: port, forced, account, execute, +4 more.

insider_tradingA

Get insider trading activity (SEC Form 4) for one or more stocks.

Returns transactions with insider name, role, transaction type, shares, price, value, date, and net buying/selling sentiment summary.

Args: symbols: Single ticker or comma-separated list (e.g., 'NVDA' or 'NVDA,PLTR,GOOG') days_back: Trailing days to look back (default 90)

Inputs: symbols (required), days_back.

news_sentimentA

Get recent news headlines for a stock.

Falls back from yfinance to Yahoo's RSS feed (source='yahoo-rss'), whose items are tagged to the ticker and may include market-wide stories. An 'error' means a source failed; only message='No news found' means there is no news.

Args: symbol: Ticker symbol limit: Number of articles to return (default 10)

Inputs: symbol (required), limit.

option_chainA

Get option chain data (calls and puts) for a specific expiration.

Args: symbol: Ticker symbol expiry: Expiration date (YYYY-MM-DD)

Inputs: expiry (required), symbol (required).

option_expiriesB

List available option expiration dates for a symbol.

Args: symbol: Ticker symbol

Inputs: symbol (required).

option_greeksA

Calculate option Greeks (delta, gamma, theta, vega) using Black-Scholes.

Computes implied volatility from market price if provided.

Args: spot: Current underlying price strike: Option strike price option_type: 'call' or 'put' expiry: Expiration date (YYYY-MM-DD) - use this OR dte dte: Days to expiration (alternative to expiry) market_price: Option market price (for IV calculation) volatility: Override volatility (decimal, e.g., 0.30) rate: Risk-free rate (default 0.05)

Inputs: spot (required), strike (required), option_type (required), dte, +4 more.

piotroski_scoreA

Calculate Piotroski F-Score (0-9) evaluating financial strength.

Scores 9 fundamental criteria including profitability, leverage, liquidity, and operating efficiency.

Args: symbol: Ticker symbol

Inputs: symbol (required).

price_correlationA

Compute price correlation matrix between multiple symbols.

Useful for portfolio diversification analysis.

Args: symbols: Comma-separated ticker symbols (minimum 2) period: Historical period (1mo, 3mo, 6mo, 1y)

Inputs: symbols (required), period.

price_historyB

Get historical OHLCV price data.

Args: symbol: Ticker symbol period: Time period (1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max) interval: Data interval (1m, 2m, 5m, 15m, 30m, 60m, 90m, 1h, 1d, 5d, 1wk, 1mo)

Inputs: symbol (required), period, interval.

report_stockA

Generate comprehensive stock analysis data with trend, PMCC, and fundamental analysis.

Returns detailed data including bullish score, PMCC viability, fundamentals, Piotroski F-Score, spread strategies, and an overall recommendation.

Args: symbol: Ticker symbol (e.g., AAPL, MSFT)

Inputs: symbol (required).

risk_assessmentA

Assess risk metrics including volatility, beta, VaR, and drawdown.

Args: symbol: Ticker symbol period: Analysis period (default 1y) position_size: Optional position size in dollars for position-specific metrics

Inputs: symbol (required), period, position_size.

scan_bullishA

Scan symbols for bullish trends using SMA, RSI, MACD, ADX.

Returns top N symbols ranked by composite bullish score.

Args: symbols: Comma-separated ticker symbols top_n: Number of top symbols to return (default 30) period: Historical period (1mo, 3mo, 6mo)

Inputs: symbols (required), top_n, period.

scan_pmccA

Scan symbols for Poor Man's Covered Call suitability.

Analyzes LEAPS and short call options for delta, liquidity, spread tightness, IV, and yield.

Args: symbols: Comma-separated ticker symbols min_leaps_days: Minimum days for LEAPS expiry (default 270) leaps_delta: Target delta for LEAPS (default 0.80) short_delta: Target delta for short call (default 0.20)

Inputs: symbols (required), leaps_delta, short_delta, min_leaps_days.

spread_diagonalA

Analyze diagonal spread (different expiries and strikes).

Includes Poor Man's Covered Call/Put analysis.

Args: symbol: Ticker symbol option_type: 'call' or 'put' long_expiry: Long leg expiration (YYYY-MM-DD) long_strike: Long leg strike short_expiry: Short leg expiration (YYYY-MM-DD) short_strike: Short leg strike

Inputs: symbol (required), long_expiry (required), long_strike (required), option_type (required), +2 more.

spread_iron_condorA

Analyze iron condor (sell strangle + buy protective wings).

Args: symbol: Ticker symbol expiry: Expiration date (YYYY-MM-DD) put_long: Long put strike (lowest) put_short: Short put strike call_short: Short call strike call_long: Long call strike (highest)

Inputs: expiry (required), symbol (required), put_long (required), call_long (required), +2 more.

spread_straddleC

Analyze long straddle (buy call + put at same strike).

Args: symbol: Ticker symbol expiry: Expiration date (YYYY-MM-DD) strike: Strike price for both legs

Inputs: expiry (required), strike (required), symbol (required).

spread_strangleA

Analyze long strangle (buy OTM call + OTM put).

Args: symbol: Ticker symbol expiry: Expiration date (YYYY-MM-DD) put_strike: Put strike (below current price) call_strike: Call strike (above current price)

Inputs: expiry (required), symbol (required), put_strike (required), call_strike (required).

spread_verticalB

Analyze vertical spread (bull/bear call/put spread).

Args: symbol: Ticker symbol expiry: Expiration date (YYYY-MM-DD) option_type: 'call' or 'put' long_strike: Strike price for long leg short_strike: Strike price for short leg

Inputs: expiry (required), symbol (required), long_strike (required), option_type (required), +1 more.

stock_quoteB

Get real-time stock quote with price, volume, change, and key metrics.

Args: symbol: Ticker symbol (e.g., AAPL, MSFT)

Inputs: symbol (required).

technical_indicatorsA

Compute technical indicators for a stock.

Args: symbol: Ticker symbol or comma-separated list period: Historical period (1mo, 3mo, 6mo, 1y) indicators: Comma-separated indicators (rsi, macd, bb, sma, ema, atr, adx) include_earnings: Include earnings data

Inputs: symbol (required), period, indicators, include_earnings.

whale_huntingA

Detect institutional whale option activity for a given underlying.

Uses a two-step approach:

  1. Crude scan via Yahoo Finance — finds contracts with anomalous daily investment.

  2. Precise drill-down via Massive API — per-second bars for each candidate.

Requires MASSIVE_API_KEY environment variable for per-second data. Falls back to Yahoo-only daily data if unavailable.

Args: symbol: Underlying ticker (e.g. AAPL, NVDA, SPY) max_months: Max months until expiration to consider (default 2) trading_date: Date to analyze YYYY-MM-DD (default: latest trading day) sigma_z: Modified Z-Score threshold for outlier detection (default 3.5) summary: If True, include per-ticker aggregate summary in result

Inputs: symbol (required), sigma_z, summary, max_months, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.3/5.0

    Scored across 36 tools

    Disambiguation3/5

    The set has clear domains (market data, options spreads, scans, IB portfolio/order management), but several tools overlap in practice: option_expiries/ib_option_expiries and option_chain/ib_option_chain differ mainly by data source, while scan_pmcc, ib_pmcc_advisor, and ib_find_short_roll all touch PMCC/roll analysis. Descriptions help distinguish them, but an agent must carefully read prerequisites and intent to avoid misselection.

    Naming Consistency3/5

    Most names use snake_case, and prefixes like ib_ and spread_ create useful grouping. However, conventions are mixed: some tools are noun phrases (stock_quote, news_sentiment), some use verb_noun (get_version, scan_bullish), and report_stock reverses the usual noun-first pattern. It remains readable but not a single predictable pattern.

    Tool Count2/5

    With 36 tools, the server is substantially over the typical 3-15 range and exceeds the 25+ threshold for a heavy surface. While the broad trading analysis domain explains some breadth, the large number of IB-specific and strategy-specific tools makes discovery and selection burdensome.

    Completeness4/5

    Coverage is strong across market data, fundamentals, calendars, technicals, risk, option chains/Greeks, many spread strategies, scans, reporting, and IB portfolio/order-management workflows. Minor gaps remain, such as general order execution beyond stops/trailing stops and some higher-level portfolio or alerting workflows, but core analysis and monitoring paths are well covered.

    Maintenance

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    • Your investing research inside Claude: watchlists, financial ratios, reverse-DCF valuations, investment theses, notes, portfolio, earnings calendar and news for the companies you follow. 70 read and write tools; ask what's on your morning desk, rank a watchlist by ROE, log a trade or save a thesis. OAuth sign-in. Free to start.

      https://mcp.investjournal.io/mcp
    • The full TraderMatrix market-data connector for Claude, Cursor and any MCP client. 51 tools: scored and tiered unusual options activity, dealer gamma (GEX), Apex levels and gamma pockets, IV rank, sector flow, dark-pool net-notional rollups, market health and macro regime, gap-continuation and breakout signals, wheel and CSP screeners, a one-call ticker snapshot, and your own watchlists. Needs a TraderMatrix API key (OAuth sign-in works for Claude web and mobile). A free, no-key connector with the gapper scanner and Market Health tools is listed separately as TraderMatrix Free.

    • Free, no-key MCP connector for market data in Claude, Cursor and any Streamable HTTP client. Six tools: a pre-market and after-hours gapper scanner (get_premarket_gappers: top 10 names up 10% or more, $1-$100, float under 100M, with premarket relative volume, ATR, RSI and a news-catalyst flag), plus the Market Health desk: S&P 500 valuation verdict (get_market_valuation), Fed liquidity and yield-curve series (get_macro_liquidity), cross-asset regime (get_cross_asset_regime), market breadth (get_market_breadth) and risk-score history (get_market_health_history). Ships with a ready-made prompt, premarket_gappers_brief. Nothing to sign up for. Built by TraderMatrix. The full TraderMatrix connector has 51 tools, adding options flow, dealer gamma and Apex levels, unusual activity, sector flow, wheel screeners and your own watchlists.

    • > TradingMCP puts a market analyst inside your AI assistant. Paste one URL into Claude, ChatGPT, Cursor, VS Code or any MCP client and ask in plain language: screen for breakouts, run a multi-timeframe analysis, backtest a strategy with walk-forward validation, scan for smart-money and volume signals, or get a one-prompt morning market brief. In clients that support MCP Apps, price charts and the Markets panel are drawn right in the chat. > 40+ tools covering crypto (real-time), stocks, ETFs, FX, futures and commodities across major global exchanges. > Hosted, nothing to install: Pro $9/month (2,500 tool calls) or Pro+ $29/month (10,000). Paid upfront with a 14-day money-back guarantee; your API key arrives right after checkout. > Built on the open-source tradingview-mcp core (MIT, ~5k GitHub stars): self-host it free, or use the hosted version with zero ops. > For research and education, not financial advice. Not affiliated with TradingView

      https://mcp.cryptosieve.com/mcp

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides a comprehensive suite of 20 tools for cryptocurrency trading and technical analysis across 100+ exchanges like Binance and MEXC via CCXT. It enables users to execute orders, track positions, and scan for market opportunities through Claude Desktop using natural language.
      20
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Connects Claude AI to Interactive Brokers accounts to enable real-time portfolio tracking, position management, and historical market data retrieval. It also integrates financial news and sentiment analysis from multiple sources, including Finnhub and IB native feeds.
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects your TastyTrade trading account to AI assistants like Claude Desktop and ChatGPT for conversational trading and portfolio management.
      5
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      Gives AI assistants real-time access to Interactive Brokers accounts via the Client Portal Web API, with 26 read-only tools for portfolio, market data, options, and scanner.
      32
      2
      MIT