Indian Stocks

An MCP (Model Context Protocol) server built in Python that provides real-time and historical data from the Indian Stock Market (BSE and NSE).

🚀 Quick Start Guide

1. Get Your API Key

1. Go to IndianAPI.in - Indian Stock Market API.
2. Sign up and copy your API key.

2. Set Up the .env File

1. Clone this repository to your computer.
2. In the root of the project folder, create a new file named exactly .env.
3. Open the .env file and paste your API key like this:

INDIAN_STOCK_API_KEY=your_api_key_here

3. Connect to Claude Desktop

To use this with Claude Desktop, update your configuration file.

(On Windows, this is usually at %APPDATA%\Claude\claude_desktop_config.json)

Add this to the mcpServers section:

{
  "mcpServers": {
    "IndiaStockExchange": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "fastmcp",
        "fastmcp",
        "run",
        "<file-path>\\main.py"
      ],
      "env": {}
    }
  }
}

Important: Replace <file-path> with the actual path where you saved this repository (e.g., C:\\Users\\yourname\\mcp-indian-stocks).

---

🛠️ Available Tools

• get-market-news - Get the latest general market news.
• get-news - Get specific Indian Stock Exchange news.
• get-stock-details - Get comprehensive details for a specific stock.
• get-stock-history - Get historical pricing data for a stock.
• get-stock-price - Get the real-time stock price.
• get-stock-recommendations - Get stock recommendations based on market trends.
• get-top-gainers - Get a list of the top gaining stocks.
• get-top-losers - Get a list of the top losing stocks.