Skip to main content
Glama
india-markets-mcp

india-markets-mcp

india-markets-mcp

CI

An MCP server that lets AI agents (Claude, Cursor, any MCP client) look up Indian equities and get simple, transparent technical signals. Built on public data via yfinance — no API keys.

Not investment advice. Data comes from Yahoo Finance and can be delayed or wrong.

Tools

Tool

What it does

get_quote(symbol)

Latest close, daily change, 52-week range, volume

get_signals(symbol)

RSI(14), 30-day volatility, max drawdown, 12-1 momentum, and a rule-based trend regime

compare_symbols(symbols, period)

Rank 2-10 symbols by return, with volatility and drawdown

Symbols: RELIANCE → RELIANCE.NS; TCS.BO and ^NSEI pass through; NIFTY, BANKNIFTY, SENSEX map to indices.

The regime label is deliberately a plain rule (close vs the 50/200-day averages and the 200-day slope) and the output includes the rule text, so an agent can explain why a label was chosen.

Related MCP server: MCP YFinance Stock Server

Reliability notes

Data comes from Yahoo Finance through the unofficial yfinance library, which can rate-limit or break without notice. To be a good citizen the server caches each (symbol, period) for 5 minutes and retries failures 3 times with backoff. Errors are explicit: SymbolNotFoundError for unknown symbols, DataSourceError when the upstream is failing.

Install and run

pip install -e .
india-markets-mcp          # starts the server over stdio

Claude Desktop / Claude Code config:

{
  "mcpServers": {
    "india-markets": { "command": "india-markets-mcp" }
  }
}

Develop

pip install -e ".[dev]"
pytest

Indicator and tool logic is pure pandas (indicators.py, core.py) and tested offline; only data.py touches the network.

Roadmap

  • Fundamentals (P/E, P/B) and sector comparison

  • Optional alternative data sources behind the same interface

  • Caching to be kinder to the upstream API

License

MIT

Available Tools

3 tools
compare_symbolsCompare SymbolsA

Rank 2-10 symbols by return over a period (1mo, 6mo, 1y, 2y, 5y), with volatility and drawdown.

Inputs: symbols (required), period. Returns: result

get_quoteGet QuoteB

Latest close, daily change and 52-week range for an NSE symbol (e.g. RELIANCE, TCS, NIFTY).

Inputs: symbol (required). Returns: object

get_signalsGet SignalsC

RSI, volatility, drawdown, 12-1 momentum and a rule-based trend regime for a symbol.

Inputs: symbol (required). Returns: object

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: single-symbol quote data, technical/statistical signals, and multi-symbol comparison. An agent can easily select the right tool based on whether it needs current pricing, derived indicators, or cross-symbol ranking.

    Naming Consistency5/5

    All tool names follow a consistent snake_case verb_noun pattern: get_quote, get_signals, compare_symbols. The verbs are appropriate and predictable for their actions.

    Tool Count4/5

    Three tools is on the lean side but appropriate for a focused market-data analytics server. Each tool earns its place, though additional utility tools may be expected for broader workflows.

    Completeness4/5

    The surface covers core quote retrieval, signal analysis, and relative comparison well. Minor gaps exist around symbol discovery, historical time-series access, or broader market/index coverage, but the stated analytics purpose is largely served.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Provides access to real-time and historical Indian stock data via Yahoo Finance API, enabling local LLMs to retrieve stock information through MCP-compatible agents like Claude Desktop and Cursor.
      2
      -
    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI agents to retrieve real-time stock data, manage watchlists, and perform comprehensive technical analysis using Yahoo Finance API. Provides 18+ tools for stock price tracking, trend analysis, volatility assessment, and financial indicators through MCP integration.
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Enables real-time and historical Indian stock market data retrieval, including prices, news, recommendations, and top gainers/losers.
      11
      -
    • A
      license
      A
      quality
      D
      maintenance
      Enables LLM clients to perform fundamental analysis of NSE/BSE-listed Indian stocks, covering financial statements, ratios, valuation, screening, and investment memos using Yahoo Finance data.
      28
      1
      MIT