Skip to main content
Glama
mcp-financex

mcp-financex

by xerktech

MCP FinanceX

PR Checks Publish npm version License: MIT

A comprehensive Model Context Protocol (MCP) server for real-time stock, cryptocurrency, options trading, SEC filings, and fundamental valuation analysis. Provides tools for price quotes, historical data, technical indicators, market news, options chains, Greeks calculation, advanced options strategy analysis, insider trading tracking (Forms 3/4/5), institutional holdings (13F), ownership changes (13D/G), material events (8-K), financial statements, and DCF valuation.

Features

Stock & Crypto Analysis

  • Real-time Price Quotes: Get current prices, changes, volume, and market data for stocks and cryptocurrencies

  • Historical Data: Retrieve OHLCV (Open, High, Low, Close, Volume) data with multiple time intervals

  • Technical Indicators: Calculate RSI, MACD, SMA, EMA, Bollinger Bands, and Stochastic oscillators

  • Market News: Fetch recent news articles for specific symbols or general market news

  • Symbol Search: Find ticker symbols by company name or keyword

  • Batch Operations: Fetch multiple quotes efficiently in a single request

  • Market Overview: Access major market indices and trending stocks

  • Watchlist Management: Track favorite symbols with notes and alerts

Options Trading

  • Options Chains: Complete options data with strikes, premiums, volume, open interest, and IV

  • Greeks Calculator: Delta, Gamma, Theta, Vega, Rho using Black-Scholes model

  • Earnings Calendar: Critical dates for volatility planning

  • Dividend Information: Ex-dividend dates affecting options pricing

  • Historical Volatility: Compare realized volatility with implied volatility

  • Implied Volatility Analysis: IV rank, percentile, and term structure

  • Max Pain Calculator: Find the pin price where most options expire worthless

  • Strategy Analyzer: Analyze complex spreads, condors, butterflies with P&L charts

Real-Time & Market Intelligence (NEW!)

  • Extended Hours Trading: Track pre-market (4 AM - 9:30 AM ET) and after-hours (4 PM - 8 PM ET) price movements

  • Short Interest Tracker: Monitor short ratio (days to cover), short % of float, and short squeeze potential

  • Analyst Ratings: Track Wall Street consensus, target prices, rating distribution, and sentiment trends

  • News Impact Analysis: Correlate news events with price movements to identify significant market-moving events

SEC Filings & Institutional Analysis (NEW!)

  • Insider Trading (Forms 3/4/5): Track CEO, director, and 10% owner buying/selling with real transaction details

  • Institutional Holdings (13F): Monitor hedge fund and institutional investor portfolios (Berkshire, Bridgewater, etc.)

  • Ownership Changes (13D/G): Track major ownership changes (5%+ stakes) and activist investor campaigns

  • Material Events (8-K): Real-time corporate event notifications (M&A, earnings, management changes, cybersecurity)

Fundamental Analysis & Valuation (NEW!)

  • Financial Statements: Access income statements, balance sheets, and cash flow statements

  • Financial Ratios: Calculate profitability, liquidity, leverage, and efficiency ratios

  • DCF Valuation: Calculate intrinsic value using Discounted Cash Flow analysis

  • Sensitivity Analysis: Test valuation assumptions (WACC, terminal growth, FCF margin)

  • Investment Recommendations: Strong Buy/Buy/Hold/Sell/Strong Sell based on upside/downside

Technical Features

  • Smart Caching: Intelligent caching with market hours awareness to minimize API calls

  • Black-Scholes Pricing: Accurate Greeks and theoretical option prices

  • No API Keys Required: Free Yahoo Finance and SEC EDGAR data (respects rate limits)

Related MCP server: market-data-mcp

Installation

Prerequisites

  • Node.js (v18 or later)

  • npm or yarn

Setup

  1. Clone the repository:

git clone https://github.com/xerktech/mcp-financex.git
cd mcp-financex
  1. Install dependencies:

npm install
  1. Build the project:

npm run build
  1. (Optional) Create a .env file for custom configuration:

cp .env.example .env

Usage

Running the Server

Development mode (with auto-reload):

npm run dev

Production mode:

npm start

Configuration with Claude Desktop

Add the server to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

Once published to npm, users can run it directly without installation:

{
  "mcpServers": {
    "finance": {
      "command": "npx",
      "args": ["-y", "mcp-financex"]
    }
  }
}

Option 2: Use from GitHub (Before npm publish)

{
  "mcpServers": {
    "finance": {
      "command": "npx",
      "args": ["-y", "github:xerktech/mcp-financex"]
    }
  }
}

Option 3: Local Installation

{
  "mcpServers": {
    "finance": {
      "command": "node",
      "args": ["/path/to/mcp-financex/dist/index.js"]
    }
  }
}

Available Tools

1. get_quote

Get real-time price quote for a stock or cryptocurrency.

Input:

{
  "symbol": "AAPL",
  "fields": ["regularMarketPrice", "marketCap"]  // Optional
}

Example:

Get the current price of Apple stock (AAPL)

Output:

{
  "symbol": "AAPL",
  "regularMarketPrice": 178.50,
  "regularMarketChange": 2.35,
  "regularMarketChangePercent": 1.33,
  "regularMarketVolume": 52438900,
  "marketCap": 2800000000000,
  "currency": "USD",
  "exchangeName": "NASDAQ",
  "quoteType": "EQUITY"
}

2. get_quote_batch

Get quotes for multiple symbols efficiently.

Input:

{
  "symbols": ["AAPL", "MSFT", "BTC-USD", "GOOGL"]
}

Example:

Get current prices for Apple, Microsoft, Bitcoin, and Google

3. get_historical_data

Retrieve historical OHLCV data.

Input:

{
  "symbol": "BTC-USD",
  "period1": "1mo",
  "interval": "1d"
}

Example:

Get the last month of daily price data for Bitcoin

Supported Intervals:

  • 1m, 5m, 15m, 30m - Intraday (limited history)

  • 1h - Hourly

  • 1d - Daily

  • 1wk - Weekly

  • 1mo - Monthly

4. calculate_indicator

Calculate technical indicators on price data.

Input:

{
  "symbol": "AAPL",
  "indicator": "rsi",
  "period": 14,
  "interval": "1d"
}

Example:

Calculate the RSI for Apple stock over the last 14 days

Supported Indicators:

  • RSI (Relative Strength Index): Momentum oscillator, identifies overbought/oversold conditions

  • MACD (Moving Average Convergence Divergence): Trend following indicator

  • SMA (Simple Moving Average): Average price over period

  • EMA (Exponential Moving Average): Weighted average giving more importance to recent prices

  • Bollinger Bands: Volatility indicator with upper/lower bands

  • Stochastic: Momentum indicator comparing closing price to price range

5. search_ticker

Search for ticker symbols by company name or keyword.

Input:

{
  "query": "Tesla",
  "limit": 10
}

Example:

Search for Tesla's ticker symbol

6. get_market_news

Retrieve recent news articles.

Input:

{
  "symbol": "AAPL",
  "limit": 10
}

Example:

Get the latest news about Apple
Get general market news (omit symbol)

SEC Filings & Institutional Analysis Tools

7. get_sec_form4_filings (Insider Trading)

Track insider trading activity from SEC Forms 3, 4, and 5. See what CEOs, directors, and major shareholders are buying or selling.

Input:

{
  "symbol": "AAPL",
  "limit": 20,
  "transactionType": "buy",  // "buy", "sell", or "all"
  "formType": "4"  // "3", "4", or "5"
}

Example:

Show me recent insider buying for Apple
What insider trades happened at Tesla?
Track Form 4 filings for NVDA

Form Types:

  • Form 3: Initial ownership statements when someone becomes an insider

  • Form 4: Changes in ownership (buy/sell transactions)

  • Form 5: Annual summary of transactions

Output: Transaction details with shares, prices, values, insider positions, and SEC filing URLs.

8. get_13f_institutional_holdings

Track what hedge funds and institutional investors are buying and selling from SEC Form 13F quarterly filings.

Input:

{
  "cik": "0001067983",  // Berkshire Hathaway CIK
  "limit": 10,
  "compareQuarters": true
}

Example:

What is Berkshire Hathaway buying? (CIK: 0001067983)
Show me Warren Buffett's latest portfolio changes
Track Bridgewater's 13F filings
What did hedge funds buy this quarter?

Famous Investors CIKs:

  • Berkshire Hathaway (Warren Buffett): 0001067983

  • Vanguard Group: 0000102909

  • BlackRock: 0001086364

Output: Institution details, portfolio holdings, quarterly changes (additions, reductions, increases, decreases).

9. get_13dg_ownership_changes

Monitor major ownership changes (5%+ stakes) and activist investor campaigns from SEC Schedule 13D and 13G filings.

Input:

{
  "symbol": "TSLA",
  "formType": "13D",  // "13D", "13G", or "both"
  "activistOnly": false
}

Example:

Show me recent 13D filings (activist investors)
Who filed major ownership stakes in Tesla?
Track activist investor activity
Recent 5%+ ownership changes

Form Types:

  • 13D: Active ownership with intent to influence company (activist investors)

  • 13G: Passive ownership without intent to influence

Output: Reporting person, ownership percentage, shares, purpose of acquisition, filing dates.

10. get_8k_material_events

Get real-time notifications of material corporate events from SEC Form 8-K current reports.

Input:

{
  "symbol": "AAPL",
  "category": "financial",  // "business", "financial", "securities", "governance", "disclosure", "all"
  "itemNumbers": ["2.02", "5.02"]  // Optional: specific item numbers
}

Example:

Show me recent 8-K filings for Apple
What are the latest material events?
Recent earnings-related 8-Ks (Item 2.02)
Management changes (Item 5.02)

Event Categories:

  • Business: Material agreements, bankruptcy, cybersecurity incidents

  • Financial: M&A completion, earnings releases, impairments

  • Securities: Delisting notices, unregistered sales

  • Governance: Director/officer changes, control changes

  • Disclosure: Regulation FD disclosures

Key Item Numbers:

  • 1.01: Material agreements

  • 1.05: Cybersecurity incidents

  • 2.01: M&A completion

  • 2.02: Earnings releases

  • 5.02: Director/officer changes

  • 8.01: Other material events

Output: Event details, item categories, filing dates, company info, SEC filing URLs.

Fundamental Analysis & Valuation Tools

11. get_financial_statements

Access comprehensive financial data from SEC 10-K (annual) and 10-Q (quarterly) filings.

Input:

{
  "symbol": "AAPL",
  "periodType": "annual",  // "annual" or "quarterly"
  "limit": 3,
  "includeRatios": true
}

Example:

Get Apple's annual financial statements
Show me Tesla's quarterly financials
What is Microsoft's profit margin?
Compare balance sheets over 4 quarters

Available Data:

  • Income Statement: Revenue, gross profit, operating income, net income, EPS, EBITDA

  • Balance Sheet: Assets, liabilities, equity, cash, debt, working capital

  • Cash Flow: Operating cash flow, capital expenditures, free cash flow

Financial Ratios Calculated:

  • Profitability: Gross margin, operating margin, net margin, ROA, ROE

  • Liquidity: Current ratio, quick ratio

  • Leverage: Debt-to-equity, debt-to-assets

  • Efficiency: Asset turnover

Output: Complete financial statements, calculated ratios, period information.

12. calculate_dcf_valuation

Calculate intrinsic value using Discounted Cash Flow (DCF) analysis with 5-year projections and terminal value.

Input:

{
  "symbol": "AAPL",
  "customInputs": {
    "revenueGrowthRates": [0.15, 0.12, 0.10, 0.08, 0.06],
    "fcfMargin": 0.25,
    "wacc": 0.10,
    "terminalGrowthRate": 0.03
  },
  "includeSensitivity": true
}

Example:

Calculate intrinsic value for Apple
Is Tesla overvalued or undervalued?
DCF analysis for NVDA with sensitivity
What is Microsoft worth based on DCF?
Should I buy this stock? (based on valuation)

Customizable Inputs:

  • Revenue growth rates (5-year projection)

  • Free cash flow margin

  • WACC (Weighted Average Cost of Capital)

  • Terminal growth rate

  • Shares outstanding, net debt

Investment Recommendations:

  • Strong Buy: >30% upside

  • Buy: 15-30% upside

  • Hold: -10% to 15%

  • Sell: -25% to -10%

  • Strong Sell: <-25% downside

Sensitivity Analysis: Tests how valuation changes with:

  • WACC variations (+/- 2%)

  • Terminal growth rate variations (+/- 1%)

  • FCF margin variations (+/- 5%)

Output: Intrinsic value per share, current price comparison, recommendation, 5-year projections, optional sensitivity analysis.

13. compare_peer_companies

Compare key financial metrics across multiple companies for competitive analysis and investment decisions.

Input:

{
  "symbols": ["AAPL", "MSFT", "GOOGL"],
  "metrics": ["marketCap", "peRatio", "netMargin", "roe"]  // Optional
}

Example:

Compare Apple, Microsoft, and Google financials
Which tech company has better margins?
Compare Tesla vs traditional automakers
Analyze competitors in the semiconductor sector

Comparison Metrics:

  • Valuation: Market cap, P/E ratio, P/B ratio, EV/EBITDA

  • Profitability: Gross margin, operating margin, net margin, ROA, ROE

  • Growth: Revenue growth, earnings growth

  • Liquidity: Current ratio, quick ratio

  • Leverage: Debt-to-equity, debt-to-assets, interest coverage

  • Efficiency: Asset turnover

  • Earnings Quality: Quality of earnings (OCF/Net Income), cash conversion rate

Rankings: Automatically ranks companies by key metrics to identify leaders and laggards.

Output: Side-by-side comparison of up to 10 companies with rankings for key metrics.

Options Trading Tools

14. get_options_chain

Get complete options chain data with all available strikes, calls, and puts.

Input:

{
  "symbol": "AAPL",
  "expirationDate": "2024-06-21"  // Optional
}

Example:

Show me the options chain for Apple
Get options for TSLA expiring June 21, 2024

Output: Calls and puts with strikes, premiums, volume, open interest, implied volatility, bid/ask spreads.

15. calculate_greeks

Calculate option Greeks (Delta, Gamma, Theta, Vega, Rho) using Black-Scholes model.

Input:

{
  "symbol": "AAPL",
  "strike": 180,
  "expirationDate": "2024-06-21",
  "optionType": "call"
}

Example:

Calculate Greeks for AAPL $180 call expiring June 21
What are the Greeks for a TSLA $250 put?

Greeks Explained:

  • Delta (0-1 for calls, -1-0 for puts): Price sensitivity - how much the option price changes per $1 move in stock

  • Gamma: Rate of delta change - how quickly delta changes as stock moves

  • Theta: Time decay - how much value the option loses per day

  • Vega: Volatility sensitivity - impact of 1% change in implied volatility

  • Rho: Interest rate sensitivity - impact of 1% change in rates

16. get_earnings_calendar

Get upcoming earnings dates and historical earnings data.

Input:

{
  "symbol": "AAPL",
  "daysAhead": 30  // Optional
}

Example:

When is Apple's next earnings date?
Show me upcoming earnings for TSLA

Why it matters: Earnings announcements cause volatility spikes, significantly impacting options prices. Options traders often avoid holding positions through earnings or specifically trade earnings volatility.

17. get_dividend_info

Get comprehensive dividend information including ex-dividend dates.

Input:

{
  "symbol": "AAPL"
}

Example:

What's Apple's dividend yield and ex-dividend date?
Get dividend information for MSFT

Why it matters: Ex-dividend dates affect options pricing, especially for calls. Stock price typically drops by the dividend amount on ex-div date.

18. calculate_historical_volatility

Calculate historical (realized) volatility for multiple periods.

Input:

{
  "symbol": "AAPL",
  "periods": [10, 20, 30, 60, 90]  // Days
}

Example:

Calculate 30-day historical volatility for TSLA
Show me historical volatility trends for AAPL

Why it matters: Compare historical volatility (HV) with implied volatility (IV) to identify overpriced or underpriced options. High IV relative to HV suggests expensive options (good for selling), while low IV relative to HV suggests cheap options (good for buying).

19. calculate_max_pain

Calculate the max pain price where most options expire worthless.

Input:

{
  "symbol": "AAPL",
  "expirationDate": "2024-06-21"  // Optional
}

Example:

What's the max pain for AAPL options?
Calculate max pain for next week's SPY expiration

Theory: Max pain theory suggests prices gravitate toward the strike where option buyers lose the most money (and option writers profit the most) as expiration approaches.

20. get_implied_volatility

Get implied volatility data and compare with historical volatility.

Input:

{
  "symbol": "AAPL"
}

Example:

What's the current IV for Tesla options?
Show me implied volatility by expiration for AAPL

Analysis provided:

  • Current ATM IV

  • IV vs HV comparison

  • IV by expiration (term structure)

  • High/low IV environment assessment

21. analyze_options_strategy

Analyze complex options strategies with P&L calculations, Greeks, and risk metrics.

Input:

{
  "symbol": "AAPL",
  "strategy": "iron_condor",
  "legs": [
    {"strike": 170, "optionType": "put", "action": "buy", "quantity": 1},
    {"strike": 175, "optionType": "put", "action": "sell", "quantity": 1},
    {"strike": 185, "optionType": "call", "action": "sell", "quantity": 1},
    {"strike": 190, "optionType": "call", "action": "buy", "quantity": 1}
  ],
  "expirationDate": "2024-06-21"
}

Supported Strategies:

  • Single options: call, put

  • Stock + option: covered_call, protective_put

  • Vertical spreads: bull_call_spread, bear_put_spread, bull_put_spread, bear_call_spread

  • Volatility: long_straddle, short_straddle, long_strangle, short_strangle

  • Advanced: iron_condor, iron_butterfly, butterfly_spread, calendar_spread, diagonal_spread

Example:

Analyze an iron condor on SPY with strikes 170/175/185/190
What's the risk/reward for a bull call spread on AAPL $175/$180?
Show me P&L chart for a covered call on TSLA at $250 strike

Output:

  • Max profit & max loss

  • Break-even points

  • Net premium/debit

  • Combined Greeks for entire position

  • P&L chart (profit/loss at various prices)

  • Risk/reward ratio

22. get_extended_hours_data

Track pre-market and after-hours trading activity.

Input:

{
  "symbol": "TSLA"
}

Example:

What's Tesla trading at in pre-market?
Show me after-hours price for AAPL
Get extended hours data for NVDA

Output:

{
  "symbol": "TSLA",
  "companyName": "Tesla, Inc.",
  "currentSession": "pre-market",
  "preMarket": {
    "price": 185.50,
    "change": 2.35,
    "changePercent": 1.28,
    "isActive": true
  },
  "regularMarket": {
    "price": 183.15,
    "change": -1.50,
    "changePercent": -0.81,
    "isOpen": false
  },
  "currentPrice": 185.50,
  "currentChange": 2.35
}

Trading Sessions:

  • Pre-market: 4:00 AM - 9:30 AM ET

  • Regular: 9:30 AM - 4:00 PM ET

  • After-hours: 4:00 PM - 8:00 PM ET

23. get_short_interest

Monitor short interest and short squeeze potential.

Input:

{
  "symbol": "GME"
}

Example:

What's the short interest for GameStop?
Show me short squeeze potential for AMC
How many days to cover short positions on TSLA?

Output:

{
  "symbol": "GME",
  "companyName": "GameStop Corp.",
  "shortInterest": {
    "shortRatio": 7.5,
    "shortPercentOfFloat": 22.3,
    "sharesShort": 15420000,
    "shortInterestChange": 1200000,
    "shortInterestChangePercent": 8.4
  },
  "squeezeAnalysis": {
    "risk": "high",
    "score": 85,
    "interpretation": "HIGH SQUEEZE RISK: high days to cover (7.5 days) and very high short interest (22.3% of float)"
  }
}

Squeeze Risk Levels:

  • High: Short ratio >10 days OR short % >30% (Score: 70-100)

  • Medium: Short ratio >3 days OR short % >15% (Score: 40-69)

  • Low: Lower short interest (Score: 0-39)

24. get_analyst_ratings

Track Wall Street analyst recommendations and target prices.

Input:

{
  "symbol": "AAPL"
}

Example:

What do analysts think about Apple?
Show me analyst ratings for Microsoft
What's the price target for NVDA?

Output:

{
  "symbol": "AAPL",
  "companyName": "Apple Inc.",
  "consensus": {
    "rating": "buy",
    "targetPrice": 195.50,
    "targetPriceHigh": 225.00,
    "targetPriceLow": 165.00,
    "numberOfAnalysts": 42
  },
  "ratingDistribution": {
    "strongBuy": 15,
    "buy": 20,
    "hold": 5,
    "sell": 2,
    "strongSell": 0,
    "total": 42
  },
  "trend": {
    "direction": "improving",
    "bullishPercent": 83.3,
    "bearishPercent": 4.8,
    "description": "Strong bullish consensus with 83% buy ratings"
  },
  "priceComparison": {
    "currentPrice": 178.50,
    "upside": 9.5,
    "upsideToHigh": 26.1
  }
}

Consensus Ratings:

  • Buy: >50% buy/strong buy ratings

  • Hold: Mixed opinions or 60%+ hold ratings

  • Sell: >50% sell/strong sell ratings

25. analyze_news_impact

Correlate news events with stock price movements.

Input:

{
  "symbol": "TSLA",
  "days_back": 30,
  "news_limit": 20
}

Example:

How does news affect Tesla's stock price?
Which news had the biggest impact on AAPL?
Analyze news correlation for Microsoft

Output:

{
  "symbol": "TSLA",
  "companyName": "Tesla, Inc.",
  "overallStatistics": {
    "correlationStrength": "strong",
    "significantImpacts": 5,
    "averageImpact1Hour": 0.8,
    "averageImpact1Day": 2.3,
    "impactDistribution": {
      "positiveNews": 12,
      "negativeNews": 5,
      "neutralNews": 3
    }
  },
  "topImpactEvents": {
    "mostPositiveImpact": {
      "title": "Tesla Deliveries Beat Expectations",
      "changePercent": 8.5,
      "impactLevel": "significant"
    },
    "mostNegativeImpact": {
      "title": "Production Delays Announced",
      "changePercent": -5.2,
      "impactLevel": "significant"
    }
  },
  "newsImpacts": [
    {
      "news": {
        "title": "Tesla Deliveries Beat Expectations",
        "timestamp": "2024-01-10T14:30:00Z"
      },
      "priceChanges": {
        "after1Hour": {
          "changePercent": 1.2
        },
        "after1Day": {
          "changePercent": 8.5
        }
      },
      "impact": {
        "level": "significant",
        "score": 92,
        "direction": "positive"
      }
    }
  ]
}

Impact Classification:

  • Significant: ≥5% price movement (Score: 70-100)

  • Moderate: 2-5% price movement (Score: 40-69)

  • Minor: 0.5-2% price movement (Score: 15-39)

  • Negligible: <0.5% price movement (Score: 0-14)

Available Resources

watchlist://default

Access your default watchlist of tracked symbols.

Example:

Show me my watchlist

market://summary

Get real-time summary of major market indices (S&P 500, Dow Jones, NASDAQ, VIX).

Example:

What's the market doing today?

market://trending

Get trending and most active stocks.

Example:

What stocks are trending?

Example Use Cases

Investment Analysis

1. Get current price of Tesla (TSLA)
2. Show me the last 6 months of daily data for TSLA
3. Calculate the 50-day moving average for TSLA
4. Calculate RSI for TSLA
5. Get latest news about Tesla

Crypto Tracking

1. Get current prices for BTC-USD, ETH-USD, and ADA-USD
2. Show me Bitcoin's price history for the last week with hourly intervals
3. Calculate MACD for Ethereum
4. What's the market summary?

Technical Analysis

1. Calculate Bollinger Bands for Apple stock
2. Show me the RSI for MSFT
3. Calculate the 20-day and 50-day moving averages for GOOGL
4. Get stochastic oscillator for SPY

Market Research

1. Search for companies in the electric vehicle sector
2. Get quotes for the top results
3. Compare their market caps and P/E ratios
4. Get news for each company

Options Trading - Pre-Earnings Analysis

1. When is Apple's next earnings date?
2. Show me the options chain for AAPL
3. What's the current implied volatility for AAPL?
4. Calculate historical volatility for comparison
5. Find options with high IV to potentially sell premium

Options Trading - Strategy Building

1. Show me TSLA options expiring next month
2. Calculate Greeks for $250 call
3. Analyze an iron condor strategy on TSLA
4. What's the max profit and max loss?
5. Show me the P&L chart

Options Trading - Risk Management

1. Get the Greeks for my AAPL $180 call position
2. What's my delta exposure?
3. How much am I losing to time decay (theta)?
4. Calculate max pain for this expiration
5. Should I hedge with a protective put?

Options Trading - Volatility Analysis

1. Compare IV vs HV for SPY
2. Is this a high or low volatility environment?
3. Show me IV by expiration (term structure)
4. Find opportunities where IV is elevated
5. Calculate historical volatility for the past 30 days

Technical Details

Data Source

All data is sourced from Yahoo Finance via the yahoo-finance2 library. Yahoo Finance provides:

  • Real-time quotes (with 15-minute delay for some markets)

  • Historical data going back many years

  • Cryptocurrency data (BTC-USD, ETH-USD, etc.)

  • No API key required

  • Free for personal and educational use

Caching Strategy

The server implements intelligent caching to minimize API calls and improve performance:

  • Quotes: 5 seconds (adjusts based on market hours)

  • Historical Data: 1 hour during market hours, 24 hours after hours

  • News: 5 minutes

  • Search Results: 1 hour

  • Technical Indicators: 5 minutes

  • Market Summary: 1 minute

Cache TTLs automatically extend during weekends and after market hours to reduce unnecessary API calls.

Error Handling

The server provides clear, actionable error messages:

  • Invalid Symbol (404): Symbol not found, check ticker

  • Validation Error (400): Invalid input parameters

  • Rate Limit (429): Too many requests, try again later

  • Network Error (502): Connection issues

  • Timeout (504): Request took too long

Technical Indicators Library

Uses the technicalindicators library for accurate, battle-tested calculations. Supports:

  • RSI with overbought/oversold signals

  • MACD with bullish/bearish crossover detection

  • Multiple moving average types

  • Bollinger Bands with bandwidth and %B calculations

  • Stochastic oscillator

CI/CD & Automation

This project uses GitHub Actions for continuous integration and deployment:

Automated Workflows

  1. PR Quality Checks - Runs on every pull request

    • Security scanning (npm audit, Trivy, TruffleHog)

    • Code quality checks (ESLint, formatting)

    • Build verification

    • Tests across multiple Node.js versions (18.x, 20.x, 22.x)

    • Dependency review

  2. Automatic Publishing - Runs on merge to main

    • Auto version bump

    • npm registry publication with provenance

    • GitHub release creation

    • Package artifact upload

Setup for Contributors

See .github/workflows/README.md for detailed workflow documentation.

Required Secrets (for maintainers):

  • NPM_TOKEN - For publishing to npm registry (requires 2FA bypass or automation token)

Development

Claude Code Integration

This project is optimized for development with Claude Code, Anthropic's official CLI tool. The .claude/ directory contains configuration and guides to help Claude work more effectively with the codebase.

For Claude Code Users:

  • .claude/CLAUDE_GUIDE.md - Quick reference for working with this codebase

  • .claude/ARCHITECTURE.md - Detailed system architecture and design decisions

  • .claude/COMMON_TASKS.md - Step-by-step workflows for common development tasks

  • .claude/settings.local.json - Pre-configured permissions for common operations

  • .claudeignore - Optimized to exclude unnecessary files from context

Getting Started with Claude Code:

# Install Claude Code (if not already installed)
npm install -g @anthropic/claude-code

# Navigate to project and start Claude
cd mcp-financex
claude

# Claude will automatically load project configuration
# Try: "Help me add a new technical indicator"

Project Structure

mcp-financex/
├── .claude/                  # Claude Code configuration
│   ├── CLAUDE_GUIDE.md      # Quick reference guide
│   ├── ARCHITECTURE.md      # System architecture
│   ├── COMMON_TASKS.md      # Development workflows
│   └── settings.local.json  # Claude permissions
├── src/
│   ├── index.ts              # Entry point
│   ├── server.ts             # MCP server setup
│   ├── tools/                # MCP tool implementations
│   ├── resources/            # MCP resource implementations
│   ├── services/             # Core services (Yahoo Finance, cache, indicators)
│   ├── types/                # TypeScript type definitions
│   └── utils/                # Utilities (error handling, validation)
├── tests/                    # Test files
├── .claudeignore             # Files to exclude from Claude context
├── package.json
├── tsconfig.json
└── README.md

Scripts

  • npm run build - Compile TypeScript to JavaScript

  • npm run dev - Run in development mode with auto-reload

  • npm start - Run compiled server

  • npm test - Run tests

  • npm run lint - Run ESLint

  • npm run format - Format code with Prettier

Testing

Run the test suite:

npm test

Run tests in watch mode:

npm run test:watch

Generate coverage report:

npm run test:coverage

Environment Variables

Configuration options (optional, defaults provided):

# Server Configuration
NODE_ENV=development
LOG_LEVEL=info

# Cache Configuration (in seconds)
CACHE_DEFAULT_TTL=300
CACHE_QUOTE_TTL=5
CACHE_HISTORICAL_TTL=3600
CACHE_NEWS_TTL=300
CACHE_SEARCH_TTL=3600
CACHE_INDICATOR_TTL=300

# Yahoo Finance Configuration
YAHOO_FINANCE_TIMEOUT=10000
YAHOO_FINANCE_RETRY_ATTEMPTS=3
YAHOO_FINANCE_RETRY_DELAY=1000

Limitations

  • Rate Limiting: Yahoo Finance has rate limits. The server implements caching and retry logic to mitigate this.

  • Real-time Data: Some quotes may have a 15-minute delay depending on the exchange.

  • Intraday Data: Intraday intervals (1m, 5m, etc.) have limited historical data (typically 7 days).

  • Crypto Coverage: Primarily supports major cryptocurrencies paired with USD (BTC-USD, ETH-USD, etc.).

  • No Authentication: Yahoo Finance data is public and doesn't require authentication, but usage should comply with Yahoo's terms of service.

Future Enhancements

Planned features for future releases:

  • Portfolio tracking and P&L calculations

  • Price alerts and notifications

  • Backtesting capabilities

  • More technical indicators (Ichimoku, Fibonacci, etc.)

  • Options data and Greeks calculations

  • Comparison tools for multiple stocks

  • Export to CSV/JSON

  • Redis caching for multi-instance deployments

  • WebSocket streaming for real-time updates

Troubleshooting

"Symbol not found" Error

Make sure you're using the correct ticker symbol format:

  • Stocks: AAPL, MSFT, GOOGL

  • Crypto: BTC-USD, ETH-USD (not BTC alone)

  • Indices: ^GSPC (S&P 500), ^DJI (Dow Jones)

"Rate limit exceeded" Error

The server is making too many requests to Yahoo Finance. The built-in caching should prevent this, but if it occurs:

  • Wait a few minutes before retrying

  • Reduce the frequency of requests

  • Check cache configuration

Connection Issues

Ensure you have a stable internet connection. The server will automatically retry failed requests up to 3 times with exponential backoff.

Publishing to npm

To make this package available for external deployment (so users can run it with npx without installation):

First-time setup:

  1. Create an npm account (if you don't have one):

    npm adduser
  2. Update package.json with your GitHub repository URL:

    "repository": {
      "type": "git",
      "url": "git+https://github.com/xerktech/mcp-financex.git"
    }
  3. Build and publish:

    npm run build
    npm publish

For updates:

  1. Update version in package.json:

    npm version patch  # 1.0.0 -> 1.0.1
    npm version minor  # 1.0.0 -> 1.1.0
    npm version major  # 1.0.0 -> 2.0.0
  2. Publish:

    npm publish

Once published, users can use it in their Claude Desktop config:

{
  "mcpServers": {
    "finance": {
      "command": "npx",
      "args": ["-y", "mcp-financex"]
    }
  }
}

This is similar to how the Alpha Vantage MCP works with uvx - users don't need to install anything locally!

Contributing

Contributions are welcome! Please:

  1. Fork the repository

  2. Create a feature branch (git checkout -b feature/amazing-feature)

  3. Commit your changes (git commit -m 'Add amazing feature')

  4. Push to the branch (git push origin feature/amazing-feature)

  5. Open a Pull Request

Please ensure:

  • Code follows the existing style (use npm run format)

  • Tests pass (npm test)

  • New features include tests

  • Documentation is updated

License

MIT License - see LICENSE file for details

Acknowledgments

Disclaimer

This software is provided for educational and informational purposes only. It is not intended as financial advice. Always do your own research and consult with a qualified financial advisor before making investment decisions. The authors are not responsible for any financial losses incurred through the use of this software.

Yahoo Finance data is subject to Yahoo's terms of service. This project is not affiliated with or endorsed by Yahoo.

Available Tools

26 tools
analyze_news_impactA

News Impact Analysis | Price Movement Correlation | Event-Driven Trading - Analyze how news events affect stock prices over time. Correlates news articles with price movements to identify which news has the most significant impact on stock performance.

Key Metrics:

  • Short-Term Impact (1 Hour): Immediate price reaction to news

  • Medium-Term Impact (1 Day): Daily price movement after news

  • Long-Term Impact (1 Week): Extended price trend following news

  • Impact Score: 0-100 score indicating magnitude of price movement

  • Impact Direction: Positive, negative, or neutral price impact

  • Correlation Strength: Overall news-price correlation (strong/moderate/weak/none)

Impact Classification:

  • Significant: ≥5% price movement (Score: 70-100)

  • Moderate: 2-5% price movement (Score: 40-69)

  • Minor: 0.5-2% price movement (Score: 15-39)

  • Negligible: <0.5% price movement (Score: 0-14)

Use Cases:

  • "How does news affect Tesla stock price?"

  • "Which news had the biggest impact on AAPL?"

  • "Analyze news correlation for Microsoft"

  • "Show me price movements after earnings news"

  • "What news caused the biggest price drop for NVDA?"

Why It Matters: News impact analysis helps:

  • Event-Driven Trading: Identify patterns in news-driven price movements

  • Risk Management: Understand how different news types affect volatility

  • Trading Strategy: Time entry/exit based on news impact patterns

  • Market Sentiment: Gauge how market reacts to different news categories

Analysis Insights:

  • Aggregate statistics across all news events

  • Most positive and negative impact events

  • Correlation between news frequency and price volatility

  • Category-specific impact patterns (earnings, M&A, analyst ratings, etc.)

Important Notes:

  • Correlation does not imply causation - other factors may influence price

  • Market-wide events can affect all stocks simultaneously

  • Low-volume stocks may show exaggerated price impacts

  • Some news may be priced in before official publication

Returns: Individual news impacts, aggregate statistics, top impacts, correlation strength, and event analysis.

Inputs: symbol (required), days_back, news_limit.

analyze_options_strategyA

Analyze an options strategy to calculate max profit, max loss, break-even points, Greeks, and generate a profit/loss chart. Supports complex multi-leg strategies like spreads, straddles, iron condors, and butterflies. Helps visualize risk/reward before entering a trade.

Inputs: legs (required), symbol (required), strategy (required), expirationDate (required).

calculate_dcf_valuationA

DCF Valuation | Intrinsic Value | Investment Analysis - Calculate intrinsic value using Discounted Cash Flow (DCF) analysis. Get 5-year cash flow projections, terminal value, and investment recommendations.

What DCF Analysis Provides:

  • Intrinsic Value: Fair value per share based on future cash flows

  • Investment Recommendation: Strong Buy, Buy, Hold, Sell, Strong Sell

  • Upside/Downside: Percentage difference vs current market price

  • 5-Year Projections: Revenue and free cash flow forecasts

  • Sensitivity Analysis: How valuation changes with different assumptions

Key Inputs (customizable):

  • Revenue growth rates (5-year projection)

  • Free cash flow margin

  • WACC (Weighted Average Cost of Capital)

  • Terminal growth rate

  • Shares outstanding, debt, cash

Investment Recommendations:

  • Strong Buy: >30% upside

  • Buy: 15-30% upside

  • Hold: -10% to 15%

  • Sell: -25% to -10%

  • Strong Sell: <-25% downside

Sensitivity Analysis: Tests valuation sensitivity to:

  • WACC changes (+/- 2%)

  • Terminal growth rate changes (+/- 1%)

  • Free cash flow margin changes (+/- 5%)

Use Cases:

  • "Calculate intrinsic value for Apple"

  • "Is Tesla overvalued or undervalued?"

  • "DCF analysis for NVDA with sensitivity"

  • "What is Microsoft worth based on DCF?"

  • "Should I buy this stock?" (based on DCF)

Returns: Intrinsic value, current price comparison, recommendation, projections, optional sensitivity analysis.

Inputs: symbol (required), customInputs, includeSensitivity.

calculate_greeksA

Calculate option Greeks (Delta, Gamma, Theta, Vega, Rho) using the Black-Scholes model. Greeks measure risk and sensitivity:

  • Delta: Price change per $1 move in underlying (0-1 for calls, -1-0 for puts)

  • Gamma: Rate of delta change

  • Theta: Daily time decay

  • Vega: Sensitivity to 1% volatility change

  • Rho: Sensitivity to 1% interest rate change

Inputs: strike (required), symbol (required), optionType (required), expirationDate (required), +3 more.

calculate_historical_volatilityA

Calculate historical volatility (realized volatility) for multiple periods. Historical volatility measures past price fluctuations and is used to compare with implied volatility to identify potential opportunities. Returns annualized volatility percentages.

Inputs: symbol (required), periods.

calculate_indicatorB

Calculate technical indicators on price data for a stock or cryptocurrency. Supports RSI, MACD, SMA, EMA, Bollinger Bands, and Stochastic oscillator. Returns calculated values with timestamps and trading signals where applicable.

Inputs: symbol (required), indicator (required), period, interval, +1 more.

calculate_max_painB

Calculate the max pain price for an options expiration. Max pain is the strike price where option holders (buyers) experience maximum loss, and option writers (sellers) experience maximum profit. Many traders believe prices gravitate toward max pain as expiration approaches.

Inputs: symbol (required), expirationDate.

compare_peer_companiesA

Peer Comparison | Competitive Analysis | Compare Companies Side-by-Side - Compare key financial metrics across multiple companies to identify relative strengths and weaknesses. Useful for competitive analysis, sector comparison, and investment decisions.

What you can compare:

  • Valuation Metrics: Market cap, P/E ratio, P/B ratio, EV/EBITDA

  • Profitability: Gross margin, operating margin, net margin, ROA, ROE

  • Growth: Revenue growth, earnings growth

  • Liquidity: Current ratio, quick ratio

  • Leverage: Debt-to-equity, debt-to-assets, interest coverage

  • Efficiency: Asset turnover

  • Earnings Quality: Quality of earnings, cash conversion rate

Use Cases:

  • "Compare Apple, Microsoft, and Google financials"

  • "Which tech company has better margins?"

  • "Compare Tesla vs traditional automakers"

  • "Analyze competitors in the semiconductor sector"

  • "Who has the strongest balance sheet among banks?"

Returns: Side-by-side comparison of key metrics for up to 10 companies.

Inputs: symbols (required), metrics.

get_13dg_ownership_changesA

13D/G Ownership Changes | Major Stakes | Activist Investors - Track major ownership changes (5%+ stakes) from SEC Schedule 13D and 13G filings. 13D filings indicate activist intent, while 13G filings indicate passive ownership.

What you can track:

  • Major ownership changes (5%+ of company shares)

  • Activist investor campaigns (Carl Icahn, Bill Ackman, etc.)

  • Passive institutional stakes (13G)

  • Potential takeover targets

  • Hedge fund 13D activity

Form Types:

  • 13D: Active ownership with intent to influence (activist investors)

  • 13G: Passive ownership without intent to influence

  • Amendments: /A suffix indicates filing updates

Use Cases:

  • "Show me recent 13D filings" (activist activity)

  • "Who filed 13D for Tesla?"

  • "Recent activist investor campaigns"

  • "Major ownership changes in tech sector"

Returns: Reporting person, ownership percentage, purpose, filing dates, direct SEC links.

Inputs: limit, symbol, formType, activistOnly.

get_13f_institutional_holdingsA

13F Institutional Holdings | Hedge Fund Tracking | See What Warren Buffett is Buying - Track institutional investor holdings from SEC Form 13F filings. 13F filings are filed quarterly by institutions managing >$100M in assets.

What you can track:

  • Hedge fund portfolio holdings (Berkshire Hathaway, Bridgewater, etc.)

  • Mutual fund positions

  • Pension fund investments

  • Quarterly changes (new positions, sold positions, increases, decreases)

  • Activist investor identification

Use Cases:

  • "What is Berkshire Hathaway buying?" (use CIK: 0001067983)

  • "Show me recent 13F filings for Bridgewater"

  • "Track quarterly changes in institutional holdings"

  • "Find activist investors"

Returns: Institution details, filing dates, holdings summaries, quarterly comparison data.

Inputs: cik (required), limit, compareQuarters.

get_8k_material_eventsA

8-K Material Events | Corporate News | SEC Current Reports - Get SEC Form 8-K current reports of material corporate events. 8-K filings are filed within 4 business days of significant events.

Event Categories Tracked:

  • Business Events: Material agreements, bankruptcy, cybersecurity incidents

  • Financial Events: M&A completion, earnings releases, impairments, debt changes

  • Securities Events: Delisting notices, unregistered sales, rights modifications

  • Governance Events: Director/officer changes, control changes, voting results

  • Disclosure Events: Regulation FD disclosures

Key Item Numbers:

  • Item 1.01: Material agreements

  • Item 1.05: Cybersecurity incidents

  • Item 2.01: M&A completion

  • Item 2.02: Earnings releases

  • Item 5.02: Director/officer changes

  • Item 8.01: Other material events

Use Cases:

  • "Show me recent 8-K filings for Apple"

  • "What are the latest material events?"

  • "Show me earnings-related 8-Ks" (Item 2.02)

  • "Recent management changes" (Item 5.02)

Returns: Event details, item categories, filing dates, company info, direct SEC links.

Inputs: limit, symbol, category, itemNumbers.

get_analyst_ratingsA

Analyst Ratings & Target Prices | Wall Street Consensus | Upgrades & Downgrades - Track analyst recommendations, price targets, and consensus changes for stocks. Get insights into what Wall Street analysts think about a company's prospects.

Key Metrics:

  • Consensus Rating: Overall buy/hold/sell recommendation from analysts

  • Target Price: Mean analyst price target with high/low/median ranges

  • Rating Distribution: Breakdown of strong buy, buy, hold, sell, strong sell ratings

  • Analyst Coverage: Number of analysts actively covering the stock

  • Price Upside/Downside: Potential gains or losses to target prices

  • Trend Analysis: Whether analyst sentiment is improving, deteriorating, or stable

Trend Indicators:

  • Improving: 50%+ buy ratings indicate bullish analyst sentiment

  • Deteriorating: 50%+ sell ratings indicate bearish analyst sentiment

  • Stable: 60%+ hold ratings or mixed opinions with no clear consensus

Use Cases:

  • "What do analysts think about Apple stock?"

  • "Show me analyst ratings for TSLA"

  • "What's the price target for Microsoft?"

  • "Which analysts are bullish on NVDA?"

  • "Is analyst sentiment improving for AMD?"

Why It Matters: Analyst ratings influence:

  • Stock Price: Upgrades often lead to price increases

  • Investor Sentiment: Wall Street opinions shape market perception

  • Trading Volume: Rating changes can trigger significant buying/selling

  • Target Setting: Price targets help investors gauge potential returns

Important Notes:

  • Analyst ratings are opinions, not guarantees

  • Consider multiple factors beyond analyst recommendations

  • Rating changes can be influenced by various factors (earnings, industry trends, etc.)

  • Strong consensus doesn't always predict future performance

Returns: Consensus rating, target prices, rating distribution, analyst coverage, upside/downside percentages, and trend analysis.

Inputs: symbol, symbols.

get_dividend_infoA

Get dividend information for a stock including dividend rate, yield, ex-dividend date, and payout ratio. Dividends affect options pricing, especially for calls around ex-dividend dates.

Inputs: symbol (required).

get_earnings_calendarA

Get upcoming earnings dates and historical earnings data for a stock. Earnings announcements significantly impact options pricing due to increased volatility. Returns earnings dates, estimates, and historical results.

Inputs: symbol, daysAhead.

get_extended_hours_dataA

Pre-Market & After-Hours Trading | Extended Session Data | Early/Late Trading Activity - Get real-time pre-market and after-hours trading data for stocks. Extended hours trading occurs before and after regular market hours, allowing traders to react to news and events.

Trading Sessions:

  • Pre-Market: 4:00 AM - 9:30 AM ET (before regular hours)

  • Regular Hours: 9:30 AM - 4:00 PM ET (standard trading)

  • After-Hours: 4:00 PM - 8:00 PM ET (after regular hours)

Data Provided:

  • Pre-market price, change, volume

  • After-hours price, change, volume

  • Regular market data (for comparison)

  • Current active session indicator

  • Most recent price across all sessions

Use Cases:

  • "Show me Apple's pre-market price"

  • "What's Tesla trading at after-hours?"

  • "Get extended hours data for NVDA"

  • "Is there pre-market activity on AAPL?"

  • "Compare regular vs after-hours price for MSFT"

Why It Matters: Extended hours trading reveals early market reactions to:

  • Earnings announcements (typically after-hours or pre-market)

  • Breaking news and geopolitical events

  • Analyst upgrades/downgrades

  • Economic data releases

Important Notes:

  • Extended hours have lower liquidity (wider spreads)

  • Prices can be more volatile

  • Not all stocks are actively traded in extended hours

Returns: Pre-market and after-hours prices, changes, current session, and comparison with regular hours.

Inputs: symbol, symbols.

get_financial_statementsA

Financial Statements | Income Statement | Balance Sheet | Cash Flow - Access comprehensive financial data from SEC 10-K (annual) and 10-Q (quarterly) filings. Get income statements, balance sheets, cash flow statements, and calculated financial ratios.

Available Data:

  • Income Statement: Revenue, gross profit, operating income, net income, EPS, EBITDA

  • Balance Sheet: Assets, liabilities, equity, cash, debt, working capital

  • Cash Flow: Operating cash flow, capital expenditures, free cash flow

  • Financial Ratios: Profitability, liquidity, leverage, and efficiency metrics

Financial Ratios Calculated:

  • Profitability: Gross margin, operating margin, net margin, ROA, ROE

  • Liquidity: Current ratio, quick ratio

  • Leverage: Debt-to-equity, debt-to-assets

  • Efficiency: Asset turnover

Use Cases:

  • "Get Apple's annual financial statements"

  • "Show me quarterly financials for Tesla"

  • "What is Microsoft's profit margin?"

  • "Compare balance sheets over 4 quarters"

  • "Calculate financial ratios for NVDA"

Returns: Complete financial statements, calculated ratios, period information, SEC filing links.

Inputs: symbol (required), limit, periodType, includeRatios.

get_historical_dataA

Retrieve historical OHLCV (Open, High, Low, Close, Volume) price data for a stock or cryptocurrency. Supports various time intervals from 1 minute to 1 month. Useful for charting and technical analysis.

Inputs: symbol (required), period1 (required), interval (required), period2.

get_implied_volatilityA

Get implied volatility (IV) data for a stock. IV represents market expectations of future volatility. Compare IV to historical volatility to identify high or low volatility environments. Returns current IV, IV by expiration, and comparison with historical volatility.

Inputs: symbol (required).

get_insider_tradesA

🚨 PRIMARY TOOL FOR: SEC, EDGAR, FORM 4, INSIDER TRADING, INSIDER BUYING, INSIDER SELLING 🚨 This tool provides DIRECT REAL-TIME ACCESS to SEC.gov EDGAR database for Form 4 insider trading filings. DO NOT say "data unavailable" - THIS TOOL CAN RETRIEVE SEC Form 4 DATA.

ALWAYS use this tool when user mentions:

  • "SEC Form 4" or "Form 4 filings" or "SEC filings" or "EDGAR"

  • "insider trading" or "insider activity" or "insider transactions"

  • "insider buying" or "insider selling" or "insider purchases/sales"

  • "what are insiders doing" or "are insiders buying/selling"

  • "latest Form 4" or "recent insider trades"

Two operating modes:

  1. Company-specific (provide symbol parameter): Returns detailed insider activity analysis for a specific stock including transaction history, net buying/selling sentiment, top insiders, and optional company fundamentals

  2. Market-wide (omit symbol parameter): Returns recent Form 4 filings across all companies in the market

Example queries this tool handles:

  • "Show me insider trading for AAPL"

  • "Are insiders buying or selling Tesla stock?"

  • "What are the latest Form 4 filings?"

  • "Recent insider purchases in the last week"

  • "Show me insider selling activity for NVDA"

Data returned: Insider names, positions, transaction types (buy/sell), shares traded, prices, transaction values, filing dates, and direct links to SEC Form 4 documents.

Inputs: limit, symbol, formType, startDate, +2 more.

get_market_newsA

Retrieve comprehensive market intelligence for a ticker symbol or general market news. When a symbol is provided with comprehensive=true, returns detailed context including: - Recent news articles with automatic categorization (earnings, M&A, legal, analyst ratings, etc.) - Company fundamentals (valuation metrics, profitability, growth, financial health) - Analyst ratings and price targets - Upcoming events (earnings dates, dividends, splits) - Institutional ownership and top holders - Insider summary (NOTE: For detailed SEC Form 4 filings, use get_insider_trades tool instead) - Short interest and options activity (volatility indicators) - Sector and industry context This comprehensive view helps LLMs understand factors affecting volatility and future price movements. For basic news only, set comprehensive=false.

Inputs: limit, symbol, comprehensive.

get_options_chainA

Get options chain data for a stock including all available calls and puts with strikes, premiums, volume, open interest, and implied volatility. Useful for analyzing available options contracts and their prices.

Inputs: symbol (required), expirationDate.

get_quoteB

Get real-time price quote for a stock or cryptocurrency ticker. Returns current price, change, volume, market cap, and other market data. Examples: AAPL (Apple), BTC-USD (Bitcoin), MSFT (Microsoft).

Inputs: symbol (required), fields.

get_quote_batchA

Get real-time quotes for multiple stock or cryptocurrency tickers efficiently in a single request. Returns quotes for all symbols with error handling for invalid symbols.

Inputs: symbols (required).

get_sec_form4_filingsA

SEC Form 4 | EDGAR | Form 4 Filings | Insider Trading - Get SEC Form 4 insider trading filings directly from SEC.gov EDGAR database. 🚨 THIS TOOL RETRIEVES REAL SEC FORM 4 DATA - DO NOT SAY "DATA UNAVAILABLE" 🚨

PRIMARY TOOL for queries about:

  • "SEC Form 4" / "Form 4 filings" / "SEC filings" / "EDGAR database"

  • "latest SEC Form 4" / "recent Form 4s" / "newest insider filings"

  • "insider trading" / "insider activity" / "insider transactions"

  • "insider buying" / "insider selling" / "insider purchases/sales"

  • "what are insiders doing" / "are insiders buying/selling"

Two operating modes:

  1. Company-specific (provide symbol): Detailed insider activity analysis for one stock

  2. Market-wide (omit symbol): Recent Form 4 filings across all companies

Example queries:

  • "What's the latest SEC Form 4 filing?"

  • "Show me recent Form 4s"

  • "Get EDGAR insider trading data for AAPL"

  • "Are insiders buying Tesla?"

Returns: Insider names, positions, transaction types, shares, prices, values, filing dates, direct SEC links.

Inputs: limit, symbol, formType, startDate, +2 more.

get_short_interestA

Short Interest Tracker | Short Squeeze Potential | Days to Cover - Track short interest, short ratio (days to cover), and short squeeze potential for stocks. Short interest indicates bearish sentiment and can lead to short squeezes when heavily shorted stocks rise.

Key Metrics:

  • Short Ratio (Days to Cover): Days it would take to cover all short positions based on average volume

  • Short % of Float: Percentage of tradeable shares that are sold short

  • Shares Short: Total number of shares sold short

  • Short Interest Change: Month-over-month change in short positions

  • Squeeze Risk Score: 0-100 score indicating short squeeze potential

Short Squeeze Indicators:

  • High Risk: Short ratio >10 days OR short % >30% (Score: 70-100)

  • Medium Risk: Short ratio >3 days OR short % >15% (Score: 40-69)

  • Low Risk: Lower short interest (Score: 0-39)

Use Cases:

  • "What's the short interest for Tesla?"

  • "Show me short squeeze potential for AMC"

  • "Which stocks have high short interest?"

  • "How many days to cover short positions on GME?"

  • "Is there short squeeze risk for TSLA?"

Why It Matters: High short interest can lead to:

  • Short Squeeze: Rapid price increase forcing shorts to cover

  • Increased Volatility: More dramatic price swings

  • Trading Opportunities: Both long and short strategies

Famous Short Squeezes:

  • GameStop (GME) - January 2021

  • AMC Entertainment - June 2021

  • Volkswagen - October 2008

Returns: Short ratio, short %, squeeze risk score, days to cover, and month-over-month changes.

Inputs: symbol, symbols.

search_tickerA

Search for stock or cryptocurrency ticker symbols by company name, keyword, or partial symbol. Returns matching tickers with their full names, exchanges, and types. Useful for finding the correct ticker symbol when you know the company name.

Inputs: query (required), limit.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.6/5.0

    Scored across 26 tools

    Disambiguation2/5

    There is significant overlap between get_insider_trades and get_sec_form4_filings, both providing SEC Form 4 insider trading data. Additionally, get_market_news also touches on insider information, creating confusion. Other tools like calculate_greeks and analyze_options_strategy may also overlap in options analysis.

    Naming Consistency4/5

    Most tools follow a consistent verb_noun pattern (e.g., get_quote, calculate_indicator). However, the redundant insider trading tools have inconsistent names (get_insider_trades vs get_sec_form4_filings) and slightly differing verb choices (analyze vs calculate). Overall pattern is predictable.

    Tool Count3/5

    With 26 tools, the server is relatively large and covers many finance domains. While each tool serves a distinct purpose, the breadth may overwhelm agents and suggests a lack of focus. The count is borderline heavy but not extreme for a comprehensive finance server.

    Completeness4/5

    The tool set covers a wide range of financial analysis needs: quotes, fundamentals, technicals, options, insider trading, news, and short interest. Minor gaps exist (e.g., no corporate actions beyond dividends), but the surface is generally complete for most user queries.

    Maintenance

    ActivityNo data
    ResponsivenessSyncing

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that provides comprehensive financial insights and analysis by leveraging real-time market data, news, and advanced analytics for stocks, options, financial statements, and economic indicators.
      17
      51
      Python
      MIT
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      Real-time financial market data MCP server. Stocks, crypto, technicals, sentiment, FDA calendar. No API keys required.
      -
    • A
      license
      B
      quality
      D
      maintenance
      An MCP server that provides comprehensive access to real-time stock quotes, financial statements, analyst estimates, and technical indicators via the Financial Modeling Prep API. It enables users to conduct in-depth financial analysis and track market performance through specialized tools, resources, and prompt templates.
      26
      47 npm
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A comprehensive MCP server for stock analysis and trading insights, including stock screening, fundamental analysis, insider trading, options analysis, social media research, and news analysis.
      10
      75
      MIT