finstack-mcp

Get real-time NSE (National Stock Exchange) quote for an Indian stock.

Returns current price, change, volume, market cap, P/E ratio, 52-week range, sector, and more.

Args: symbol: NSE stock symbol (e.g., RELIANCE, TCS, INFY, HDFCBANK, SBIN, ITC)

Examples: nse_quote("RELIANCE") → Reliance Industries live price & stats nse_quote("TCS") → TCS live price & stats nse_quote("HDFCBANK") → HDFC Bank live price & stats

Get real-time BSE (Bombay Stock Exchange) quote for an Indian stock.

Returns current price, change, volume, market cap, and key ratios.

Args: symbol: BSE stock symbol (e.g., RELIANCE, TCS, INFY)

Examples: bse_quote("RELIANCE") → Reliance Industries BSE price bse_quote("TCS") → TCS BSE price

Check if the Indian stock market (NSE/BSE) is currently open or closed.

Returns market status (OPEN, CLOSED, PRE_OPEN, POST_CLOSE), trading hours, and current IST time.

No arguments needed.

Examples: nse_market_status() → Shows if market is open right now

Get current value of Indian market indices.

Returns the current value, change, change %, day's high/low, and 52-week range for the specified index.

Args: index_name: Index name. Options: - NIFTY50 (or NIFTY) - Nifty 50 index - SENSEX - BSE Sensex - BANKNIFTY - Nifty Bank index - NIFTYIT - Nifty IT index - NIFTYPHARMA - Nifty Pharma index - ALL - Get all major indices at once

Examples: nifty_index("NIFTY50") → Current Nifty 50 value nifty_index("SENSEX") → Current Sensex value nifty_index("ALL") → All major indices

Get historical price data (OHLCV) for an NSE stock.

Returns open, high, low, close, volume data for the specified period. Also includes summary stats: period return %, high, low, avg volume.

Args: symbol: NSE stock symbol (e.g., RELIANCE, TCS, INFY) period: Time period. Options: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max interval: Data interval. Options: 1m, 5m, 15m, 30m, 1h, 1d, 5d, 1wk, 1mo Note: 1m data only available for last 7 days

Examples: nse_historical("RELIANCE", "1mo", "1d") → 1 month daily data nse_historical("TCS", "1y", "1wk") → 1 year weekly data nse_historical("INFY", "5y", "1mo") → 5 year monthly data nse_historical("SBIN", "5d", "15m") → 5 day intraday (15min candles)

Get today's top performing stocks on NSE.

Returns the top 10 stocks by the specified criteria from Nifty 50 components.

Args: mover_type: Type of movers to fetch. Options: - gainers: Top 10 stocks with highest % gain today - losers: Top 10 stocks with highest % loss today - active: Top 10 stocks by trading volume

Examples: nse_top_movers("gainers") → Today's top gainers nse_top_movers("losers") → Today's top losers nse_top_movers("active") → Most actively traded stocks

Get the latest NAV and details for any Indian mutual fund.

Searches the AMFI database — no API key required.

Args: query: Fund name (e.g. "SBI Bluechip", "HDFC Flexi Cap") or numeric scheme code (e.g. "119598")

Examples: mutual_fund_nav("SBI Bluechip") → NAV, change, 7-day history mutual_fund_nav("Axis Long Term") → ELSS fund NAV mutual_fund_nav("119598") → Fetch by scheme code directly

Scan NSE stocks currently hitting upper or lower circuit limits.

Checks Nifty 500 stocks where the current price is frozen at the intraday high (upper circuit) or intraday low (lower circuit).

Args: circuit_type: "upper" (locked at high), "lower" (locked at low), or "both" (default)

Examples: nse_circuit_breakers("upper") → Stocks hitting upper circuit today nse_circuit_breakers("lower") → Stocks hitting lower circuit today nse_circuit_breakers("both") → All circuit-locked stocks

Get the list of stocks in Nifty 50 or Sensex with live prices.

Returns all constituent stocks with current price, % change today, market cap, plus top 5 gainers and losers within the index.

Args: index_name: "nifty50" (default) or "sensex"

Examples: sensex_components("nifty50") → All 50 Nifty stocks with live prices sensex_components("sensex") → All 30 Sensex stocks with live prices

Scan Nifty 50 stocks near their 52-week high or low.

This is the most popular scan on Screener.in — stocks breaking out near 52-week highs are momentum candidates; those near 52-week lows may be value opportunities or falling knives.

Args: scan_type: "near_high" — stocks within threshold% of 52w high (default) "near_low" — stocks within threshold% of 52w low "both" — return both lists threshold_pct: Closeness threshold in % (default 5.0 = within 5% of extreme)

Examples: nse_52week_scanner("near_high", 5) → Stocks near all-time high area nse_52week_scanner("near_low", 10) → Stocks near 52-week low nse_52week_scanner("both", 3) → Very tight near both extremes

Get real-time stock quote for any global stock.

Works for US, UK, European, Asian, and Indian stocks. Returns price, change, volume, market cap, P/E, sector, country, and more.

Args: symbol: Stock ticker symbol. Formats: - US stocks: AAPL, MSFT, GOOGL, TSLA, AMZN - UK stocks: HSBA.L, BP.L, VOD.L - Japan: 7203.T (Toyota), 6758.T (Sony) - Hong Kong: 0700.HK (Tencent) - India: RELIANCE.NS, TCS.NS (use nse_quote for Indian stocks)

Examples: stock_quote("AAPL") → Apple live price stock_quote("MSFT") → Microsoft live price stock_quote("TSLA") → Tesla live price

Get historical price data for any global stock.

Returns OHLCV data with summary stats.

Args: symbol: Stock ticker (e.g., AAPL, MSFT, TSLA) period: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max interval: 1m, 5m, 15m, 30m, 1h, 1d, 5d, 1wk, 1mo

Examples: stock_historical("AAPL", "1y", "1d") → Apple 1 year daily stock_historical("TSLA", "3mo", "1wk") → Tesla 3 month weekly

Get live cryptocurrency price in USD.

Returns current price, 24h change, market cap, volume, and all-time high.

Args: symbol: Crypto ticker (e.g., BTC, ETH, SOL, XRP, DOGE, ADA, MATIC, DOT)

Examples: crypto_price("BTC") → Bitcoin live price crypto_price("ETH") → Ethereum live price crypto_price("SOL") → Solana live price

Get historical cryptocurrency price data.

Args: symbol: Crypto ticker (e.g., BTC, ETH, SOL) period: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, max interval: 1m, 5m, 15m, 30m, 1h, 1d, 1wk, 1mo

Examples: crypto_historical("BTC", "1y", "1d") → Bitcoin 1 year daily crypto_historical("ETH", "3mo", "1wk") → Ethereum 3 month weekly

Get live forex exchange rate between two currencies.

Returns current rate, day's change, high/low, and 52-week range.

Args: from_currency: Source currency code (e.g., USD, EUR, GBP, AED, JPY) to_currency: Target currency code (default: INR)

Examples: forex_rate("USD", "INR") → US Dollar to Indian Rupee forex_rate("EUR", "INR") → Euro to Indian Rupee forex_rate("AED", "INR") → UAE Dirham to Indian Rupee forex_rate("USD", "EUR") → US Dollar to Euro forex_rate("GBP", "USD") → British Pound to US Dollar

Get latest market news for a stock or general market.

Returns up to 10 recent news articles with title, publisher, and link.

Args: symbol: Stock ticker for company-specific news (optional). Leave empty for general market news.

Examples: market_news("AAPL") → Apple-related news market_news("RELIANCE.NS") → Reliance Industries news market_news() → General market news

Get SEC filings for a US-listed company.

Returns links to actual filing documents on SEC EDGAR.

Args: symbol: US stock ticker (e.g., AAPL, MSFT, GOOGL) filing_type: Type of filing. Options: - 10-K: Annual report - 10-Q: Quarterly report - 8-K: Current events report - ALL: All filing types count: Number of filings to return (default: 5, max: 20)

Examples: sec_filing("AAPL", "10-K") → Apple annual reports sec_filing("TSLA", "10-Q", 3) → Tesla last 3 quarterly reports sec_filing("MSFT", "ALL", 10) → Microsoft all recent filings

Search SEC EDGAR for a company and get their filing page.

Returns company info (CIK number) and link to their SEC filings page. Use sec_filing() to get specific filing documents.

Args: symbol: US stock ticker (e.g., AAPL, MSFT, GOOGL)

Examples: sec_filing_search("AAPL") → Find Apple on SEC EDGAR sec_filing_search("NVDA") → Find NVIDIA on SEC EDGAR

Get income statement (Profit & Loss) for a company.

Returns revenue, COGS, gross profit, operating income, net income, EPS, EBITDA, and other P&L line items.

Works for both Indian (NSE/BSE) and US stocks.

Args: symbol: Stock ticker (e.g., RELIANCE, TCS, AAPL, MSFT) quarterly: If True, returns quarterly data. If False (default), annual data.

Examples: income_statement("RELIANCE") → Reliance annual P&L (last 4 years) income_statement("TCS", quarterly=True) → TCS quarterly P&L income_statement("AAPL") → Apple annual P&L

Get balance sheet for a company.

Returns total assets, total liabilities, shareholder equity, cash, debt, inventory, receivables, and more.

Args: symbol: Stock ticker (e.g., RELIANCE, TCS, AAPL, MSFT) quarterly: If True, quarterly data. If False (default), annual.

Examples: balance_sheet("HDFCBANK") → HDFC Bank annual balance sheet balance_sheet("AAPL", quarterly=True) → Apple quarterly balance sheet

Get cash flow statement for a company.

Returns operating cash flow, investing cash flow, financing cash flow, free cash flow, capital expenditure, and more.

Args: symbol: Stock ticker (e.g., INFY, SBIN, GOOGL, AMZN) quarterly: If True, quarterly data. If False (default), annual.

Examples: cash_flow("INFY") → Infosys annual cash flow cash_flow("GOOGL", quarterly=True) → Google quarterly cash flow

Get key financial ratios and valuation metrics for a company.

Returns comprehensive metrics organized into categories:

• Valuation: P/E, P/B, EV/EBITDA, PEG ratio, price-to-sales

• Profitability: ROE, ROA, profit margin, operating margin, gross margin

• Growth: Revenue growth, earnings growth

• Financial Health: Debt/equity, current ratio, quick ratio, free cash flow

• Per Share: EPS, book value, revenue per share

• Dividend: Yield, payout ratio, ex-dividend date

Works for both Indian and US stocks.

Args: symbol: Stock ticker (e.g., RELIANCE, TCS, AAPL, MSFT)

Examples: key_ratios("RELIANCE") → Reliance complete ratio analysis key_ratios("AAPL") → Apple valuation & financial metrics key_ratios("HDFCBANK") → HDFC Bank financial health check

Get company overview and profile information.

Returns company name, sector, industry, country, number of employees, website, business description, exchange, and market cap.

Args: symbol: Stock ticker (e.g., RELIANCE, TCS, AAPL, MSFT)

Examples: company_profile("RELIANCE") → What does Reliance Industries do? company_profile("TSLA") → Tesla company overview company_profile("INFY") → Infosys company details

Get historical dividend payments for a stock.

Returns past dividend dates and amounts, total dividends paid, average dividend, and latest dividend info.

Args: symbol: Stock ticker (e.g., ITC, COALINDIA, AAPL, MSFT)

Examples: dividend_history("ITC") → ITC dividend payment history dividend_history("COALINDIA") → Coal India dividends dividend_history("AAPL") → Apple dividend history

Compute technical indicators for a stock with buy/sell signals.

Calculates RSI, MACD, SMA (20/50/200), EMA, Bollinger Bands, ATR, Stochastic, ADX, OBV — all computed locally, no API cost.

Works for Indian (NSE/BSE) and US stocks.

Args: symbol: Stock ticker (e.g., RELIANCE, TCS, AAPL, TSLA) period: Data period for calculation: 3mo, 6mo, 1y, 2y (default: 6mo) indicators: Comma-separated list of specific indicators. Options: RSI, MACD, SMA, EMA, BBANDS, ATR, STOCH, ADX, OBV Leave empty for ALL indicators.

Examples: technical_indicators("RELIANCE") → All indicators for Reliance technical_indicators("AAPL", "1y") → Apple with 1 year data technical_indicators("TCS", "6mo", "RSI,MACD,SMA") → Only RSI, MACD, SMA

Compare 2-5 stocks side by side.

Shows price, P/E, P/B, ROE, profit margin, revenue growth, debt/equity, dividend yield, beta, sector, and 52-week range for each stock in a comparison table format.

Args: symbols: Comma-separated stock symbols (2-5 stocks). e.g., "RELIANCE,TCS,INFY" or "AAPL,MSFT,GOOGL"

Examples: compare_stocks_tool("RELIANCE,TCS,INFY") → Compare 3 Indian IT giants compare_stocks_tool("AAPL,MSFT,GOOGL,AMZN") → Compare US tech compare_stocks_tool("HDFCBANK,ICICIBANK,SBIN,KOTAKBANK") → Compare banks

Get performance of Nifty sectoral indices.

Shows how different sectors (Banking, IT, Pharma, FMCG, Auto, Metal, Realty, Energy) performed today, with best and worst performers highlighted.

No arguments needed.

Examples: sector_performance() → Which sectors are up/down today?

Get FII (Foreign Institutional Investor) and DII (Domestic Institutional Investor) activity data.

Shows how much foreign and domestic institutions bought/sold today. FII net buy = bullish signal. DII net buy = domestic accumulation.

No arguments needed.

Examples: nse_fii_dii_data() → Today's FII/DII activity

Get recent bulk and block deals on NSE.

Shows large transactions where quantity traded exceeds 0.5% of total shares. Useful for tracking institutional activity.

No arguments needed.

Examples: nse_bulk_deals() → Recent bulk/block deals

Get corporate actions for an NSE stock — dividends, stock splits, bonuses.

Shows recent and historical corporate actions with dates and values.

Args: symbol: NSE stock symbol (e.g., ITC, RELIANCE, TCS, COALINDIA)

Examples: nse_corporate_actions("ITC") → ITC dividends and splits nse_corporate_actions("RELIANCE") → Reliance corporate actions

Get latest quarterly financial results for an NSE stock.

Shows revenue, profit, EPS, EBITDA for last 4 quarters with quarter-over-quarter growth rates.

Args: symbol: NSE stock symbol (e.g., RELIANCE, TCS, INFY, HDFCBANK)

Examples: nse_quarterly_results("RELIANCE") → Reliance Q results nse_quarterly_results("TCS") → TCS quarterly financials

Get upcoming earnings dates for a stock.

Shows when a company is expected to report earnings, along with analyst estimates (EPS and revenue).

Args: symbol: Stock ticker (e.g., RELIANCE, AAPL). Required.

Examples: earnings_calendar("RELIANCE") → When does Reliance report next? earnings_calendar("AAPL") → Apple earnings date

Get upcoming and recent IPOs on NSE.

Shows company name, price band, dates, issue size, and status.

No arguments needed.

Examples: ipo_calendar() → What IPOs are coming up?

Screen stocks by multiple financial criteria. [PRO]

Filter Nifty 50 or S&P 500 stocks by P/E ratio, ROE, market cap, dividend yield, debt/equity ratio, and sector.

Args: exchange: "NSE" for Indian stocks, "US" for US stocks (default: NSE) pe_max: Maximum P/E ratio (e.g., 15 for value stocks). 0 = no filter. pe_min: Minimum P/E ratio. 0 = no filter. roe_min: Minimum Return on Equity in % (e.g., 20). 0 = no filter. market_cap_min: Minimum market cap in USD (e.g., 1000000000 for $1B). 0 = no filter. dividend_yield_min: Minimum dividend yield in % (e.g., 2). 0 = no filter. debt_equity_max: Maximum debt-to-equity ratio (e.g., 50). 0 = no filter. sector: Filter by sector name (e.g., "Technology", "Financial"). Empty = all. limit: Max number of results (default: 15)

Examples: stock_screener("NSE", pe_max=15, roe_min=20) → Value stocks with high ROE stock_screener("NSE", dividend_yield_min=3) → High dividend yield stocks stock_screener("US", pe_max=20, sector="Technology") → Cheap US tech stocks

Compute support and resistance levels for a stock. [PRO]

Calculates pivot points (R1, R2, R3, S1, S2, S3) and identifies key price levels from historical price action.

Args: symbol: Stock ticker (e.g., RELIANCE, AAPL, TCS) period: Data period: 3mo, 6mo, 1y, 2y (default: 6mo)

Examples: support_resistance("RELIANCE") → Key levels for Reliance support_resistance("AAPL", "1y") → Apple support/resistance with 1yr data

Get options chain data for an NSE stock or index. [PRO]

Returns call and put options with strike price, premium, volume, open interest, implied volatility, and Put-Call Ratio (PCR).

Args: symbol: NSE stock or index symbol (e.g., RELIANCE, NIFTY, BANKNIFTY, TCS)

Examples: nse_options_chain("RELIANCE") → Reliance options chain nse_options_chain("NIFTY") → Nifty 50 options chain nse_options_chain("BANKNIFTY") → Bank Nifty options

Analyze a stock portfolio — P&L, weights, risk. [PRO]

Provide your holdings and get total P&L, individual stock performance, portfolio weights, concentration risk, winners and losers.

Args: holdings: JSON string of holdings array. Each holding needs: symbol, quantity, buy_price. Example: '[{"symbol":"RELIANCE","quantity":10,"buy_price":2500}, {"symbol":"TCS","quantity":5,"buy_price":3800}]'

Examples: portfolio_analysis('[{"symbol":"RELIANCE","quantity":10,"buy_price":2500}]') portfolio_analysis('[{"symbol":"AAPL","quantity":5,"buy_price":150}, {"symbol":"MSFT","quantity":3,"buy_price":380}]')

Backtest a Simple Moving Average (SMA) crossover strategy. [PRO]

Tests: Buy when short SMA crosses above long SMA, sell when it crosses below. Compares strategy return vs buy-and-hold.

Args: symbol: Stock ticker (e.g., RELIANCE, AAPL, TCS) short_window: Short SMA period in days (default: 20) long_window: Long SMA period in days (default: 50) period: Backtest period: 1y, 2y, 5y (default: 2y) initial_capital: Starting capital (default: 100000)

Examples: backtest_strategy("RELIANCE") → Default 20/50 SMA backtest backtest_strategy("AAPL", 10, 30, "5y") → Custom 10/30 SMA, 5 years backtest_strategy("TCS", 50, 200, "5y", 500000) → Golden cross, 5L capital

Return basic server metadata and useful links.