# Indian Stock Exchange MCP Server

MCP Server for providing detailed financial data for companies listed on the Bombay Stock Exchange (BSE) and National Stock Exchange (NSE), empowering users with comprehensive insights into the dynamic Indian stock market.

For more details, visit - [Indian Stock Market API](https://indianapi.in/indian-stock-market)

## Tools

(For API details, please visit - [Indian Stock Market API](https://indianapi.in/indian-stock-market))

- **get-news** - Get Indian Stock Exchange News  
- **get-stock-details** - Get details for a specific stock  
- **get-stock-history** - Get historical data for a specific stock  
- **get-stock-price** - Get the latest stock price for a specific stock  
- **get-trending-stocks** - Get currently trending stocks  
- **get-top-gainers** - Get the top gaining stocks  
- **get-top-losers** - Get the top losing stocks  
- **get-commodities** - Get commodities market data  
- **get-price-shockers** - Get stocks with significant price movement  

## Setup

### 1. Download the Repo and Set Your API Key
Clone the repository, then create `src/.env` (gitignored — never commit this
file) with your API key:

```sh
echo "ISE_API_KEY=<your Indian Stock Exchange API key>" > src/.env
```

### 2. Install Packages and Build
Run the following commands to install dependencies and build the project:

```sh
npm install
npm run build
```

### 3. Installing on Claude Desktop
Before starting, ensure Node.js is installed on your desktop for npx to work.

Go to: Settings > Developer > Edit Config

Add the following to your claude_desktop_config.json (see
`mcp-config.example.json` for a copy-pasteable template — **never commit
a copy of this file with a real key filled in**):

```sh
{
  "mcpServers": {
    "IndiaStockExchange": {
      "command": "node",
      "args": [
        "<path_to_project>/build/index.js"
      ],
      "env": {
        "ISE_API_KEY": "<your Indian Stock Exchange API key>"
      }
    }
  }
}
```

### 4. Restart Claude Desktop
After updating the configuration, restart Claude Desktop to apply the changes.