nsei-mcp-server
If you are the rightful owner of nsei-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol (MCP) server that provides access to NSEI trade data through a standardized interface.
National Stock Exchange of India (NSEI) MCP Server
A Model Context Protocol (MCP) server that provides access to NSEI trade data through a standardized interface. This server allows AI assistants like Claude to access financial data programmatically.
Features
- Get top Movers: Access the top movers — gainers and losers for any given time period (presently limiting upto any 3 months interval)
- Get latest trades: Retrieve latest trades for further analysis of the day's movements
Installation
Prerequisites
- Python 3.8 or higher
- UV package manager (recommended) or pip
- Financial Modeling Prep API key
Setup
-
Clone this repository
-
Install dependencies using UV (recommended):
uv venv uv pip install -r requirements.txtOr using pip:
pip install -r requirements.txt
Running the Server
Using UV (Recommended)
UV provides faster dependency resolution and installation. To run the server with UV:
# Activate the virtual environment
uv venv activate
# Run the server
python nsei_mcp_server.py
The server will start and listen for connections on the default MCP port.
Using pip
# Create and activate a virtual environment
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# Run the server
python fmp_mcp_server.py
Connecting with Claude Desktop
Claude Desktop can connect to MCP servers to access financial data. Here's how to set it up:
- Download Claude Desktop
- If you're running the server from previous steps, you may shut it down since Claude Desktop will spawn a local server by itself.
- Edit claude_desktop_config.json:
"fmp_mcp_server": {
"command": "uv",
"args": [
"--directory",
"REPLACE ME WITH ABSOLUTE DIRECTORY TO REPO",
"run",
"fmp_mcp_server.py"]
}
Now Claude can use the FMP data through the MCP interface. You can ask Claude to:
- Get top movers for the day from NSE
- Retrieve trades for a particular stock — "how did RIL perform today?"
- And more!
Example Queries for Claude
Once connected, you can ask Claude questions like:
- "How did SBI's stock perform today?"
- "Was RIL among the top movers today?"
- "Find me the biggest losers by percentage points in today's equity market trading"
Caching
Will be implemented in future versions
Logging
Logs are written to the logs directory with rotation enabled:
- Maximum log file size: 10MB
- Number of backup files: 5
License
Acknowledgements
- Shadi Copty's FMP MCP Server for providing the API
- MCP Server QuickStart guide for the Model Context Protocol quick start guides implementation
