🇮🇳 india-markets-mcp
Give your AI agent a live view of the Indian stock market. Quotes, transparent technical signals, valuation and sector comparison for NSE/BSE, over MCP. No API keys.
See it work
You: Can you give me the price of TCS, and is it a good time to buy?
Agent (calls the india-markets tools): TCS closed at ₹2,407.50 on 13 Nov 2026, down 1.43% on the day. Whether it's a good time to buy is your decision. I can't give buy, sell or hold advice, but here is where the stock stands.
Metric Value 52-week range ₹1,961.36 – ₹3,187.34 Distance from 52-week high −24.5% RSI(14) 50.7 (neutral) 30-day volatility (annualised) 32.8% 50-day / 200-day average ₹2,287.43 / ₹2,366.05 Market cap ₹8,71,055 crore
(Condensed from a real session using the bundled skill, so the agent reports facts instead of advice. Numbers move with the market.)
▶ Watch the 20-second version with sound
Why this one
- Built for India.
RELIANCEjust works.NIFTY,BANKNIFTYandSENSEXare first-class. Market cap comes back in ₹ crore, not dollars. - Signals you can audit. The trend regime is a plain rule on the 50/200-day averages and the 200-day slope, and the tool returns the rule text, so the agent can explain why, not just emit a label.
- Honest about gaps. Missing data is
null, never guessed. Unknown tickers and upstream outages raise clear errors. - Polite to the data source. 5-minute cache, 3 retries with backoff, bounded fan-out.
- Tested offline. Indicator and tool logic is pure pandas with 34 tests, run in CI on Linux, macOS and Windows.
- Comes with an agent skill that teaches the agent when to use each tool and keeps answers to facts, not buy/sell calls.
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, rule-based trend regime |
compare_symbols(symbols, period) |
Rank 2-10 symbols by return, with volatility and drawdown |
get_fundamentals(symbol) |
Market cap (₹ crore), P/E, P/B, ROE, debt/equity, dividend yield, sector |
compare_fundamentals(symbols) |
Side-by-side valuation of 2-10 symbols, cheapest P/E first |
sector_peers(symbol) |
A large-cap vs hand-picked same-sector peers: median P/E and P/B and its premium or discount |
Symbols: RELIANCE → RELIANCE.NS · TCS.BO and ^NSEI pass through · NIFTY, BANKNIFTY, SENSEX map to the indices.
Try asking
- "Give me a quick read on HDFCBANK: price, trend and valuation."
- "Rank INFY, TCS, WIPRO and HCLTECH by 1-year return and by P/E."
- "Is Reliance expensive compared with other oil and gas names?"
- "Which of the big private banks has the lowest drawdown this year?"
Install
Claude Desktop / Claude Code / Cursor (any MCP client). Install, then add the server:
pip install git+https://github.com/Aarya-Mhatre69/india-markets-mcp
{
"mcpServers": {
"india-markets": { "command": "india-markets-mcp" }
}
}
With Claude Code you can register it in one line:
claude mcp add india-markets -- india-markets-mcp
If the command isn't on your PATH, use the full path to the executable (for a venv: .venv/Scripts/india-markets-mcp.exe on Windows, .venv/bin/india-markets-mcp elsewhere).
Optional: the agent skill
skills/india-markets/SKILL.md teaches an agent which tool to pick, how to read units and nulls, and to stay on facts (no buy/sell advice, ends with a disclaimer). Copy the folder into .claude/skills/ (Claude Code) or your agent's skills directory.
How it works
your agent ──MCP──▶ server.py ──▶ core.py ──▶ indicators.py (pure pandas, tested offline)
│
└──▶ data.py ──▶ yfinance (cache + retry) ← only network code
Only data.py touches the network, so everything else is deterministic and easy to test.
Good to know
- Not investment advice. Signals describe the past; they do not predict.
- Data comes from Yahoo Finance via the unofficial
yfinancelibrary. It can be delayed, rate-limited or wrong, and Yahoo's terms limit commercial use. Fine for research and learning, not for trading systems. - Fundamentals can be
null(loss-making companies, new listings, gaps in the source). sector_peersuses a small hand-picked list insectors.py, not an official classification. Edit it if you disagree with a grouping.
Develop
git clone https://github.com/Aarya-Mhatre69/india-markets-mcp
cd india-markets-mcp
pip install -e ".[dev]"
pytest
Contributions welcome: new peer groups, a better data source behind the same interface, more indicators. Open an issue first for anything big.
Roadmap
- Quotes, signals, comparison
- Fundamentals and sector peers
- Caching, retries, CI, agent skill
- Portfolio view: pass holdings, get concentration, sector mix and drawdown
- Pluggable data sources behind one interface
- Nifty 50 screener (oversold + cheap vs peers)
License
MIT
Metadata
Release files for india-markets-mcp 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| india_markets_mcp-0.1.0.tar.gz | 2.0 MB | With provenance | Details for india_markets_mcp-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| india_markets_mcp-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for india_markets_mcp-0.1.0-py3-none-any.whl |
Total release size: 2.0 MB
Release files / india_markets_mcp-0.1.0.tar.gz
| Download URL | india_markets_mcp-0.1.0.tar.gz |
|---|---|
| Size | 2.0 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b654458c5258617bd692465cae233b4ea63255190839a75ea017b7f96e29efd0
|
|
BLAKE2b-256 checksum How to use checksums |
4212c0e93012ecf72d0c0136158a37dd3d417ed770651d29facf894149d7b083
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.
Transparency logRelease files / india_markets_mcp-0.1.0-py3-none-any.whl
| Download URL | india_markets_mcp-0.1.0-py3-none-any.whl |
|---|---|
| Size | 12.8 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
823287108bfde7620725347aa1a952bb652d15b2d1f0b12e23362c1fde51dbb6
|
|
BLAKE2b-256 checksum How to use checksums |
d5bf7f524e6b9232b53a744474edaaadbf461f498e87953cd1b1a2513e07a285
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.16
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.
Transparency logSecurity for india-markets-mcp 0.1.0
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
Full provenance
Both files in this release have been uploaded with provenance metadata.
Attestation for india_markets_mcp-0.1.0.tar.gz
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Nov 15, 2026.
Transparency logA note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.