get_historical_candleLABSCO SUMMARY
One tool, five intervals, a fixed symbol list.
The scope is deliberately small: historical candles and nothing else — no quotes, no orders, no positions. Symbol resolution comes from a CSV in the repo rather than a live lookup, so a ticker that is missing there is missing for you too; check the file before assuming a symbol is unsupported.
What it is
A market-data server for India's National Stock Exchange, reading through the Upstox API. It answers with historical candles, so an assistant can reason about a price series instead of guessing at one.
What you get
get_historical_candlereturns open, high, low, close and volume for an NSE symbol over a date range you choose- Five intervals:
minute,30minute,day,weekandmonth - Validation and error messages that name the problem — an unknown symbol, a bad date format, a connection failure or an upstream API error
- Symbols and their instrument keys come from
configs/NSE.csvin the repository
Requirements
The project nse-ticker-mcp, version 0.1.0, installed from a checkout: clone it, make a virtualenv, pip install -e .. Python 3.12 or higher (the project's pyproject.toml requires it, although the README says 3.11), with mcp, pandas, httpx and pydantic pulled in as dependencies. The client launches ticker.py from the project directory.
Setup effort
Build from source — git clone https://github.com/sougatabh/nse-ticker-mcp.git
USE CASES
01
Analysing how a stock moved over a quarter
Pull daily candles between two dates and let the assistant work from the actual series.
02
Looking at intraday behaviour around an event
Switch the interval to minute or 30-minute bars for the day in question.
03
Comparing two names on the same footing
Request the same date range and interval for each symbol so the comparison is like for like.
1 tool
Listed in project docs. Your client may show a different list.
BEFORE YOU INSTALL
What to know first
Tools you get
1 tool named in the project's documentation.
Requires
Python 3.12 or later
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/sougatabh/nse-ticker-mcp.git
cd nse-ticker-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e .MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"nse-ticker": {
"command": "<YOUR_PATH_TO_NSE_TICKER_MCP>/.venv/bin/python",
"args": [
"<YOUR_PATH_TO_NSE_TICKER_MCP>/ticker.py"
]
}
}
}<YOUR_PATH_TO_NSE_TICKER_MCP> is the full path of your clone. The block runs ticker.py with the Python in the .venv the steps create. The README's own block passes --directory to python, which python does not accept.
