mcp-financex
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., "@mcp-financex get current price of AAPL"
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.
MCP FinanceX
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
Clone the repository:
git clone https://github.com/xerktech/mcp-financex.git
cd mcp-financexInstall dependencies:
npm installBuild the project:
npm run build(Optional) Create a
.envfile for custom configuration:
cp .env.example .envUsage
Running the Server
Development mode (with auto-reload):
npm run devProduction mode:
npm startConfiguration 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
Option 1: Use npx (Recommended - No Installation Required)
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 Google3. 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 BitcoinSupported Intervals:
1m,5m,15m,30m- Intraday (limited history)1h- Hourly1d- Daily1wk- Weekly1mo- 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 daysSupported 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 symbol6. 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 NVDAForm 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 changesForm 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 quartersAvailable 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 sectorComparison 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, 2024Output: 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 TSLAWhy 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 MSFTWhy 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 AAPLWhy 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 expirationTheory: 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 AAPLAnalysis 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 strikeOutput:
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 NVDAOutput:
{
"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 MicrosoftOutput:
{
"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 watchlistmarket://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 TeslaCrypto 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 SPYMarket 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 companyOptions 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 premiumOptions 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 chartOptions 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 daysTechnical 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
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
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.mdScripts
npm run build- Compile TypeScript to JavaScriptnpm run dev- Run in development mode with auto-reloadnpm start- Run compiled servernpm test- Run testsnpm run lint- Run ESLintnpm run format- Format code with Prettier
Testing
Run the test suite:
npm testRun tests in watch mode:
npm run test:watchGenerate coverage report:
npm run test:coverageEnvironment 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=1000Limitations
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,GOOGLCrypto:
BTC-USD,ETH-USD(notBTCalone)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:
Create an npm account (if you don't have one):
npm adduserUpdate package.json with your GitHub repository URL:
"repository": { "type": "git", "url": "git+https://github.com/xerktech/mcp-financex.git" }Build and publish:
npm run build npm publish
For updates:
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.0Publish:
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:
Fork the repository
Create a feature branch (
git checkout -b feature/amazing-feature)Commit your changes (
git commit -m 'Add amazing feature')Push to the branch (
git push origin feature/amazing-feature)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
Model Context Protocol by Anthropic
yahoo-finance2 for Yahoo Finance API access
technicalindicators for technical analysis calculations
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 toolsanalyze_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:
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
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:
Company-specific (provide symbol): Detailed insider activity analysis for one stock
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
Scored across 26 tools
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.
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.
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.
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
Related MCP Connectors
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
Production MCP server for US equity and options intelligence: real-time IV radar, Monte Carlo simulation, options pressure, strategy backtesting, AI prediction, pre-trade risk analysis, and automated stock research reports.
The Octagon MCP server provides specialized AI-powered financial research and analysis by integrating with the Octagon Market Intelligence API. It enables users to analyze public market data (SEC filings, earnings transcripts, financial metrics, and stock data for 8000+ companies), private market data (3M+ companies, 500k+ funding rounds, 2M+ M&A/IPO transactions), and conduct deep research including web scraping capabilities. The server also features autonomous research agents that search hundreds of sources and return fully cited reports in approximately one minute.
MCP server for Financial Modeling Prep API with 250+ financial data tools
Related MCP Servers
- AlicenseBqualityDmaintenanceAn 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.1751PythonMIT
- -licenseNot gradedqualityNot gradedmaintenanceReal-time financial market data MCP server. Stocks, crypto, technicals, sentiment, FDA calendar. No API keys required.-
- AlicenseBqualityDmaintenanceAn 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.2647 npm1MIT
- AlicenseAqualityDmaintenanceA comprehensive MCP server for stock analysis and trading insights, including stock screening, fundamental analysis, insider trading, options analysis, social media research, and news analysis.1075MIT