Moneycontrol

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

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

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).