trading-skills
This MCP server provides AI-callable tools for market research, options analytics, scanning, reporting, and Interactive Brokers portfolio/order management.
Fetch stock quotes, historical OHLCV, fundamentals, Piotroski scores, earnings/economic calendars, news sentiment, and insider trades.
Compute technical indicators, price correlations, and risk metrics such as volatility, beta, VaR, and drawdown.
Analyze options expiries/chains, Black-Scholes Greeks and IV, and spreads: verticals, diagonals/PMCCs, straddles, strangles, and iron condors.
Scan symbols for bullish trends or PMCC suitability, and detect institutional whale option activity.
Generate comprehensive stock reports combining trend, PMCC, fundamental, and recommendation data.
With Interactive Brokers/TWS: view accounts and portfolios, option expiries/chains, roll candidates, collars, PMCC advice, delta exposure, and portfolio action reports.
Manage IBKR risk/orders with dry-run defaults: stop-loss, trailing stops, and 0DTE EMA+VIX credit spreads; optionally execute live orders.
Retrieve IBKR trade execution history, including extended history via FlexReport.
Return the installed trading-skills package version.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@trading-skills Scan AAPL, MSFT, NVDA for bullish trends"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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.
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"

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 syncRun 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
Install the package (requires Python 3.12+):
pip install trading-skillsFind the full path to the installed command:
macOS / Linux:
which trading-skills-mcpWindows:
where trading-skills-mcpIf
wheredoesn't find it, locate it manually:python -c "import sysconfig; print(sysconfig.get_path('scripts'))"The script will be
trading-skills-mcp.exein that directory (typically atC:\Users\<YourUsername>\AppData\Local\Programs\Python\Python<Version>\Scripts\)Open Claude Desktop, go to Settings → Developer → Edit Config:

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.
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 |
| Real-time price, volume, change, market cap, 52-week range |
| Calls and puts with strikes, bids, asks, volume, OI, IV |
| Historical OHLCV data |
| Financials, earnings, key metrics, Piotroski F-Score |
| Recent headlines and sentiment |
| Upcoming earnings dates with BMO/AMC timing and EPS estimates |
| Scheduled US economic events (CPI, NFP, FOMC, GDP...) in ET, with optional ForexFactory cross-check |
| SEC Form 4 insider transactions — executive buys/sells and sentiment |
Analysis
Skill | Description |
| RSI, MACD, Bollinger Bands, SMA, EMA, ATR, ADX, correlation matrix |
| Delta, gamma, theta, vega, IV (Black-Scholes) |
| Verticals, diagonals, straddles, strangles, iron condors |
| Volatility, beta, VaR, drawdown, Sharpe ratio |
| JPG chart: daily candles, EMA 9/20 with crossovers marked, RSI panel |
Scanners
Skill | Description |
| Scan symbols for bullish trends (SMA, RSI, MACD, ADX) |
| Scan for PMCC suitability (delta, liquidity, spread, IV, yield) |
| 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-exposureRead-write — can place and cancel conditional orders in TWS:
ib-stop-loss(only when--executeis passed; dry-run by default)
Skill | Description |
| Account summary (cash, buying power, margin) |
| Portfolio positions with market prices |
| Real-time option chain data from IB (under development) |
| Roll candidates for short positions or covered call/put selection |
| Tactical collar strategy for earnings/event protection |
| PMCC position analysis: assignment risk, P&L projections, ranked roll candidates |
| Conditional stop-loss management for PMCC, naked LEAPS, and stock positions |
| Portfolio review with earnings risk and action items |
| Consolidate IBRK trade CSVs into summary reports |
| Delta-adjusted notional exposure across accounts |
Reports
Skill | Description |
| 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_exposureRead-write (places/cancels orders):
ib_stop_losswhenexecute=True
Category | Tools |
Market Data |
|
Technical |
|
Options |
|
Spreads |
|
Scanners |
|
Whale Hunting |
|
Reports |
|
IB Portfolio |
|
† 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:
Install TWS or IB Gateway
Enable API connections in TWS: Configure → API → Settings → Enable ActiveX and Socket Clients
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_hereThe 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
envblock 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.serverArchitecture
User Query → Claude Code/Desktop → Skill or MCP Tool → Python Script → ResponseSkills 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 |
All market data, fundamental, and options skills | Free; up to 15-minute delay | |
Massive (formerly Polygon.io) |
| Paid API key required; see setup section below |
License
MIT
Available Tools
36 toolsearnings_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:
Crude scan via Yahoo Finance — finds contracts with anomalous daily investment.
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
Scored across 36 tools
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.
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.
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.
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
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.
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
Related MCP Servers
- AlicenseBqualityDmaintenanceProvides 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.20MIT
- FlicenseNot gradedqualityCmaintenanceConnects 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.-
- AlicenseNot gradedqualityDmaintenanceConnects your TastyTrade trading account to AI assistants like Claude Desktop and ChatGPT for conversational trading and portfolio management.5MIT
- AlicenseBqualityDmaintenanceGives 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.322MIT