Skip to main content
Glama
moneycontrol-mcp

moneycontrol-mcp

Moneycontrol MCP Server

An MCP server that exposes Moneycontrol market data as tools an AI agent can call: symbol search, live equity quotes, fundamentals & ratios, index levels, FII/DII institutional activity (cash market + F&O), market news, and technical pivot levels.

Moneycontrol has no official public API. This server talks to the same public endpoints the Moneycontrol website and app use (priceapi.moneycontrol.com, the autosuggest service, the FII/DII page's embedded data, and RSS feeds). It is intended for personal/informational use; respect Moneycontrol's terms of service and avoid hammering the endpoints. All data is read-only.

Tools

Tool

What it does

moneycontrol_search

Search a stock or index by name → resolve its sc_id, symbol, ISIN, sector. Call this first to get the sc_id other tools need.

moneycontrol_get_quote

Live equity quote: price, change, OHLC, 52-week range, volume, market cap.

moneycontrol_get_fundamentals

Valuation ratios (P/E standalone & consolidated, industry P/E, P/B), book value, cash EPS, face value, dividend yield, sector, and 1w–5y returns.

moneycontrol_get_index

Current level/movement for an index (Nifty 50, Sensex, Nifty Bank, sectoral indices, …).

moneycontrol_fii_dii

FII & DII net activity in ₹ crore — cash market headline plus F&O segments, by day.

moneycontrol_get_news

Current news headlines for a topic/stock (query) or a category (markets, latest, business, economy, results, stocks, ipo, mutual-funds). Pass a company name for stock-specific news.

moneycontrol_get_technicals

Pivot points and support/resistance levels (daily/weekly/monthly).

moneycontrol_get_history

Historical OHLCV bars for an NSE stock — daily/weekly/monthly or intraday (1m–1h).

Every tool accepts response_format: "markdown" (default, human-readable) or "json" (structured, for programmatic use).

Related MCP server: india-stock-mcp

Install

Requires Python 3.10+. Uses uv (or plain pip).

uv venv --python 3.11
uv pip install -e .

Run

# stdio transport (for local MCP clients)
uv run moneycontrol-mcp
# or
uv run python -m moneycontrol_mcp

Use with Claude Code / Claude Desktop

Add to your MCP client config (e.g. claude_desktop_config.json), using absolute paths:

{
  "mcpServers": {
    "moneycontrol": {
      "command": "uv",
      "args": ["--directory", "/ABSOLUTE/PATH/TO/Money control mcp", "run", "moneycontrol-mcp"]
    }
  }
}

In Claude Code:

claude mcp add moneycontrol -- uv --directory "/ABSOLUTE/PATH/TO/Money control mcp" run moneycontrol-mcp

Quick test

uv run python scripts/smoke_test.py

This calls every tool against the live endpoints and prints the results.

Example agent flow

  1. moneycontrol_search(query="HDFC Bank") → sc_id: "HDF01"

  2. moneycontrol_get_quote(symbol="HDF01") → live price

  3. moneycontrol_get_fundamentals(symbol="HDF01") → P/E, P/B, dividend yield

  4. moneycontrol_fii_dii(days=5, segment="cash") → were foreigners buying this week?

(The quote/fundamentals/technicals tools also accept a plain company name and will auto-resolve it via search, but passing the sc_id is faster and unambiguous.)

Notes & limitations

  • Cash market FII/DII figures (fiiCM/diiCM) are the headline numbers; F&O segments are also exposed via segment="fno" or "all".

  • Index codes for the most common indices are built in; any other index name is resolved at runtime via Moneycontrol search.

  • Historical data (moneycontrol_get_history) is for NSE equities via the techCharts feed; index history and BSE-only scrips are not currently supported.

  • Commodity/forex quotes are not included: Moneycontrol's public price feed requires contract/expiry-specific codes for those and is not reliably accessible.

  • Top gainers/losers, options chain, and corporate actions are not included: Moneycontrol does not expose clean public JSON endpoints for these. If you need them, the NSE-backed tools in sibling MCP servers (e.g. finstack's nse_top_movers / nse_options_chain / nse_corporate_actions, or dhan) cover that ground.

  • Data reflects whatever Moneycontrol publishes (often delayed during market hours; provisional FII/DII data updates after market close).

Available Tools

8 tools
moneycontrol_fii_diiA
Read-onlyIdempotent

Get FII (foreign) and DII (domestic) institutional net activity, in INR crore.

The cash market is the headline figure most analysts watch: positive FII cash = foreign buying. F&O segments (index/stock futures & options) are also available. A positive number = net buying; negative = net selling.

Args: params (FiiDiiInput): - days (int): Recent trading days to return (1-60, default 10). - segment (str): 'cash' (default), 'fno', or 'all'. - response_format (ResponseFormat): 'markdown' or 'json'.

Returns: str: A list of daily rows (most recent first). Each row (JSON mode): { "date": str, "fii_cash": float, "dii_cash": float, "net_cash": float, # when segment is 'fno' or 'all': "fii_index_fut": float, "fii_index_opt": float, "fii_stock_fut": float, "fii_stock_opt": float, "nifty_close": str, "nifty_change_pct": str } All cash/F&O figures are net values in INR crore. Returns "Error: ..." on failure.

Inputs: params (required). Returns: result

moneycontrol_get_fundamentalsA
Read-onlyIdempotent

Get valuation ratios, per-share metrics, sector and trailing returns for a stock.

Covers P/E (standalone & consolidated), industry P/E, P/B, book value, cash EPS, face value, dividend yield, market cap, sector classification, and price returns over 1w / 1m / 3m / 1y / YTD plus 5-year CAGR.

Args: params (FundamentalsInput): - symbol (str): sc_id (preferred) or company name. - exchange (str): 'nse' (default) or 'bse'. - response_format (ResponseFormat): 'markdown' or 'json'.

Returns: str: Fundamentals with this shape (JSON mode): { "name": str, "sc_id": str, "sector": str, "sub_sector": str, "pe": str, "pe_consolidated": str, "industry_pe": str, "pb": str, "book_value": str, "cash_eps": str, "face_value": str, "dividend_yield": str, "market_cap_cr": str, "returns": {"1w": str, "1m": str, "3m": str, "1y": str, "ytd": str, "cagr_5y": str} } Returns "Error: ..." on failure.

Inputs: params (required). Returns: result

moneycontrol_get_historyA
Read-onlyIdempotent

Get historical OHLCV price bars for an NSE stock (daily/weekly/monthly or intraday).

Args: params (HistoryInput): - symbol (str): NSE trading symbol (e.g. 'RELIANCE', 'HDFCBANK') or company name. - interval (str): 1m, 5m, 15m, 30m, 1h, daily (default), weekly, monthly. - count (int): Number of most-recent bars (1-500, default 30). - response_format (ResponseFormat): 'markdown' or 'json'.

Returns: str: Bars ordered oldest → newest. Each bar (JSON mode): {"time": str, "open": float, "high": float, "low": float, "close": float, "volume": float} JSON mode wraps them as {"symbol", "ticker", "interval", "count", "bars": [...]}. Returns "Error: ..." on failure (e.g. no data at that resolution).

Inputs: params (required). Returns: result

moneycontrol_get_indexA
Read-onlyIdempotent

Get the current level and movement for a market index.

Built-in fast-path names: Nifty 50, Sensex, Nifty Bank, Nifty IT, Nifty Auto, Nifty Pharma, Nifty FMCG, Nifty Metal, Nifty Midcap 100, Nifty Smallcap 100, Nifty 500. Other index names are resolved automatically via Moneycontrol search.

Args: params (IndexInput): - index (str): Index name or raw pricefeed code. - response_format (ResponseFormat): 'markdown' or 'json'.

Returns: str: Index data with this shape (JSON mode): { "name": str, "level": str, "change": str, "percent_change": str, "open": str, "high": str, "low": str, "prev_close": str, "advances": str, "declines": str, "year_high": str, "year_low": str, "ytd_percent": str } Returns "Error: ..." on failure.

Inputs: params (required). Returns: result

moneycontrol_get_newsA
Read-onlyIdempotent

Get current Moneycontrol news headlines for a topic, stock, or category.

Pass a query for targeted news (a company name gives stock-specific news; a topic like 'rbi policy' or 'crude oil' gives that theme). With no query, a category supplies a sensible default search: markets, latest, business, economy, results, stocks, ipo, mutual-funds.

Args: params (NewsInput): - query (Optional[str]): Topic/stock/keyword. Overrides category. - category (str): Default category when query is omitted ('markets'). - limit (int): Max headlines (1-50, default 15). - response_format (ResponseFormat): 'markdown' or 'json'.

Returns: str: A list of current articles. Each (JSON mode): {"title": str, "link": str} Returns "No news found..." when nothing matches.

Inputs: params (required). Returns: result

moneycontrol_get_quoteA
Read-onlyIdempotent

Get a live equity quote: price, change, OHLC, 52-week range, volume, market cap.

Args: params (QuoteInput): - symbol (str): sc_id (preferred) or company name. - exchange (str): 'nse' (default) or 'bse'. - response_format (ResponseFormat): 'markdown' or 'json'.

Returns: str: Quote data with this shape (JSON mode): { "name": str, "symbol": str, "exchange": str, "sc_id": str, "price": str, "change": str, "percent_change": str, "prev_close": str, "open": str, "high": str, "volume": str, "week52_high": str, "week52_low": str, "market_cap_cr": str, "market_state": str, "last_updated": str } Returns "Error: ..." on failure (e.g. unknown symbol).

Inputs: params (required). Returns: result

moneycontrol_get_technicalsA
Read-onlyIdempotent

Get pivot points and support/resistance levels for a stock.

Args: params (TechnicalsInput): - symbol (str): sc_id (preferred) or company name. - exchange (str): 'nse' (default) or 'bse'. - period (str): 'D' (daily, default), 'W', or 'M'. - response_format (ResponseFormat): 'markdown' or 'json'.

Returns: str: OHLC for the period plus pivot tables. JSON mode returns the raw Moneycontrol structure including pivotLevels (Classic, Fibonacci, etc.). Returns "Error: ..." on failure.

Inputs: params (required). Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: FII/DII data, fundamentals, history, index, news, quote, technicals, and search. No two tools overlap in functionality; an agent can easily select the right one.

    Naming Consistency4/5

    Most tools follow the pattern 'moneycontrol_get_<noun>' (e.g., get_fundamentals, get_quote), but moneycontrol_fii_dii omits 'get_' and moneycontrol_search uses 'search' instead of 'get_search'. The deviation is minor and still readable.

    Tool Count5/5

    With 8 tools, the set is well-scoped for a financial data server. Each tool covers a distinct aspect of market data (quotes, history, indices, fundamentals, technicals, news, institutional flows, and search), fitting the domain without being bloated.

    Completeness4/5

    The tool surface covers essential financial data operations: live quotes, historical prices, indices, fundamentals, technicals, news, and institutional activity. Minor gaps exist (e.g., no options/futures data, corporate actions), but core workflows are supported.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server that provides comprehensive Indian stock market data from the NSE and BSE, including live quotes, historical trends, and fundamental analysis. Users can compare stock performance, track major indices, and access financial statements without the need for an API key.
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for Indian stock market data. Provides 16 tools for quotes, history, fundamentals, mutual funds, indices, corporate actions, options, IPOs, and portfolio analysis.
      16
      90 npm
      5
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      MCP server providing real-time Indian stock market data through 15 tools, including stock details, historical data, market overview, and news. Works with Claude Desktop, Claude Code, Cursor, Windsurf, and other MCP clients using an API key from IndianAPI.in.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server providing fundamental and technical data on Indian-listed companies from Screener.in and Yahoo Finance, including financial statements, ratios, and technical indicators.
      12
      MIT