Indian Stock Market MCP Server

MCP server that provides real-time access to Indian stock market data through 15 tools. Works with Claude Desktop, Claude Code, Cursor, Windsurf, and any MCP-compatible client.

Powered by IndianAPI.in.

Prerequisites

• Node.js 18+ (Download)

• API Key from IndianAPI.in - subscribe to get your API key and base URL

Related MCP server: NSE/BSE MCP Server

Installation

The server runs via npx - no clone or install needed.

Universal Config Shape

Every MCP client uses the same config structure:

{
  "mcpServers": {
    "indian-stock-market": {
      "command": "npx",
      "args": ["-y", "indian-stock-market-mcp"],
      "env": {
        "INDIAN_STOCK_API_KEY": "your_api_key_here",
        "INDIAN_STOCK_API_BASE_URL": "https://your-api-base-url.com"
      }
    }
  }
}

Claude Desktop

Add to your Claude Desktop config file:

Paste the universal config shape above, then restart Claude Desktop.

Claude Code

claude mcp add indian-stock-market \
  -e INDIAN_STOCK_API_KEY=your_api_key_here \
  -e INDIAN_STOCK_API_BASE_URL=https://your-api-base-url.com \
  -- npx -y indian-stock-market-mcp

Cursor

Add the universal config shape to .cursor/mcp.json in your project root (or global settings).

Windsurf

Add the universal config shape to ~/.codeium/windsurf/mcp_config.json.

Available Tools (15)

Stock Information

• get_stock_details - Detailed info about any stock

• get_historical_data - Historical price data with multiple timeframes

• get_stock_target_price - Analyst target prices

• get_corporate_actions - Dividends, bonuses, splits

• get_recent_announcements - Latest company announcements

• get_financial_statement - Income statement, balance sheet, cash flow

Market Overview

• get_trending_stocks - Currently trending stocks

• get_nse_most_active - Most active NSE stocks

• get_bse_most_active - Most active BSE stocks

• get_price_shockers - Significant gainers and losers

• get_52_week_high_low - Stocks at 52-week extremes

Market Data

• get_market_news - Latest market news

• get_ipo_data - Current and upcoming IPOs

• get_commodities - Commodity prices

• search_industry - Find stocks by sector/industry

Usage Examples

Once configured, use natural language in your AI assistant:

Get me the latest details for Tata Steel

Show me the 1-year price history for HDFC Bank

What are the trending stocks today?

Find all banking stocks and their performance

Get financial statements for Infosys - income statement and balance sheet

Give me today's market briefing: NSE most active, price shockers, and commodity prices

Tool Reference

get_stock_details

Returns: Stock price, market cap, P/E, 52-week high/low, volume, etc.

get_historical_data

get_financial_statement

get_corporate_actions

get_recent_announcements

get_stock_target_price

search_industry

Zero-parameter tools

get_trending_stocks, get_market_news, get_nse_most_active, get_bse_most_active, get_price_shockers, get_52_week_high_low, get_ipo_data, get_commodities — no parameters required.

Environment Variables

Response Filtering

The server automatically filters and limits API responses to stay within token limits:

• Stock Details — essential fields only (price, market cap, P/E, 52-week high/low, volume, sector)

• List Responses — top 20 items with essential fields

• Historical Data — last 100 data points

• Financial Statements — arrays limited to 10 items

• News/Announcements — 15 items, descriptions truncated to 300 chars

• Fallback — if still >20,000 tokens, a summary is returned with data type, count, and sample

Development

For contributors working on the server itself:

git clone https://github.com/aswin-s/indian-stock-market-mcp.git
cd indian-stock-market-mcp
bun install

# Create .env with your API credentials
cp .env.example .env

# Build TypeScript to dist/
bun run build

# Run in development mode (uses tsx, no build step needed)
bun run dev

Adding New Tools

1. Add a server.registerTool(...) call in src/index.ts

2. Add response filtering logic in filterResponse() if needed

3. Update this README

Troubleshooting

"INDIAN_STOCK_API_KEY not found" / "INDIAN_STOCK_API_BASE_URL is required"

Ensure the environment variables are set in your MCP client config (see Installation above).

"Cannot find module '@modelcontextprotocol/sdk'"

If running from source, run bun install (or npm install). If using npx, try npx -y indian-stock-market-mcp to force a fresh install.

Server not appearing in your client

1. Verify the config JSON is valid (no trailing commas)

2. Restart your MCP client completely

3. Check client logs for errors

API requests timing out

Default timeout is 30 seconds. If your API is slower, modify the timeout value in createApiClient in src/index.ts.

API Endpoints

License

MIT