moneycontrol-mcp
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., "@moneycontrol-mcp get quote for Reliance Industries"
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.
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 |
| Search a stock or index by name → resolve its |
| Live equity quote: price, change, OHLC, 52-week range, volume, market cap. |
| Valuation ratios (P/E standalone & consolidated, industry P/E, P/B), book value, cash EPS, face value, dividend yield, sector, and 1w–5y returns. |
| Current level/movement for an index (Nifty 50, Sensex, Nifty Bank, sectoral indices, …). |
| FII & DII net activity in ₹ crore — cash market headline plus F&O segments, by day. |
| Current news headlines for a topic/stock ( |
| Pivot points and support/resistance levels (daily/weekly/monthly). |
| 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_mcpUse 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-mcpQuick test
uv run python scripts/smoke_test.pyThis calls every tool against the live endpoints and prints the results.
Example agent flow
moneycontrol_search(query="HDFC Bank")→sc_id: "HDF01"moneycontrol_get_quote(symbol="HDF01")→ live pricemoneycontrol_get_fundamentals(symbol="HDF01")→ P/E, P/B, dividend yieldmoneycontrol_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 viasegment="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'snse_top_movers/nse_options_chain/nse_corporate_actions, ordhan) cover that ground.Data reflects whatever Moneycontrol publishes (often delayed during market hours; provisional FII/DII data updates after market close).
Available Tools
8 toolsmoneycontrol_fii_diiARead-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_fundamentalsARead-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_historyARead-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_indexARead-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_newsARead-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_quoteARead-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_technicalsARead-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
moneycontrol_searchARead-onlyIdempotent
Search Moneycontrol for a stock or index and resolve its identifiers.
Use this FIRST to obtain a stock's sc_id (needed by moneycontrol_get_quote,
moneycontrol_get_fundamentals, moneycontrol_get_technicals) or to discover an
index name accepted by moneycontrol_get_index.
Args: params (SearchInput): - query (str): Name to search. - kind (str): 'stock' (default) or 'index'. - limit (int): Max results (1-25, default 10). - response_format (ResponseFormat): 'markdown' or 'json'.
Returns: str: Matches. Each record has: { "sc_id": str, # Moneycontrol id, e.g. "RI" — pass to quote/fundamentals "name": str, # Display name "symbol": str, # Trading symbol, e.g. "RELIANCE" "isin": str, # ISIN if available "bse_code": str, # BSE numeric code if available "sector": str, "link": str # Moneycontrol page URL } Returns "No matches..." when nothing is found.
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
Scored across 8 tools
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.
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.
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.
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
Hosted MCP server for Indian NSE/BSE stock research: 59 tools for quotes, financials and ratios, peers, shareholding and pledge, filings with extracted facts, screens, F&O and FII/DII context. Source and freshness on every answer; no buy/sell calls.
MCP server for Financial Modeling Prep API with 250+ financial data tools
Official Intrinio MCP server. US stock prices, options and fundamentals for AI agents.
A Model Context Protocol server exposing real-time and historical Colombo Stock Exchange (CSE) data to AI agents and LLM applications. Provides quotes and OHLCV price history, full financial statements (income, balance sheet, cash flow), pre-computed technicals (moving averages, RS ratings, volume signals), macroeconomic indicators, corporate actions, and rule-based screening across CSE stocks and sector indices, everything needed to build CSE-aware trading assistants, research tools, and market-analysis agents. This is the official MCP server of www.ceyloncharts.com
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceAn 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.2MIT
- AlicenseAqualityDmaintenanceMCP server for Indian stock market data. Provides 16 tools for quotes, history, fundamentals, mutual funds, indices, corporate actions, options, IPOs, and portfolio analysis.1690 npm5MIT
- AlicenseNot gradedqualityDmaintenanceMCP 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
- AlicenseAqualityDmaintenanceMCP server providing fundamental and technical data on Indian-listed companies from Screener.in and Yahoo Finance, including financial statements, ratios, and technical indicators.12MIT