home / mcp / nse_bse mcp server

NSE_BSE MCP Server

Model Context Protocol server for NSE and BSE India stock market APIs using Streamable HTTP transport.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "bshada-nse-bse-mcp": {
      "url": "http://localhost:3000/mcp"
    }
  }
}

The NSE-BSE MCP Server provides a Model Context Protocol endpoint for real-time NSE and BSE India stock market data. It lets you query a wide range of market data and related documents, while enabling large language models to analyze and act on that data efficiently through a streamable HTTP transport.

How to use

You access the MCP server from a client that supports MCP, such as Gemini CLI, Claude Desktop, or ChatGPT. Start the server locally to expose the MCP API, then configure your client to connect to the server's endpoint. You can run the server directly with a quick-start command, or start it from source after installation.

How to install

Prerequisites: you need a modern Node.js/npm or Bun-enabled environment. You will install dependencies, build if needed, and then start the MCP server.

Available tools

nse_get_market_status

Current market status and trading hours for NSE markets.

nse_equity_quote

Real-time equity quotes for NSE securities.

nse_get_quote

Quote with segment specification (equities, SME, MF, debt) for NSE assets.

nse_lookup_symbol

Search NSE symbols by full or partial name.

nse_get_gainers

Top gainers from NSE market data.

nse_get_losers

Top losers from NSE market data.

nse_equity_historical

Historical equity data for a given date range.

nse_fno_historical

Historical Futures/Options data for NSE.

nse_vix_historical

Historical volatility index data for NSE.

nse_get_expiry_dates

Available expiry dates for a symbol (requires symbol first).

nse_option_chain

Complete option chain with all strikes (V3 API).

nse_filtered_option_chain

Compact option chain around ATM strikes with reduced size.

nse_compile_option_chain

Pre-calculated analytics for option chains (ATM, max pain, PCR, OI).

nse_calculate_max_pain

Max pain strike price calculation for options.

nse_fno_lots

F&O lot sizes for all symbols.

nse_futures_expiry

Futures expiry dates.

nse_corporate_actions

Dividends, splits, and corporate actions.

nse_corporate_announcements

Corporate announcements.

nse_board_meetings

Board meeting information.

nse_annual_reports

Company annual reports.

nse_circulars

NSE circulars.

nse_current_ipos

Currently ongoing IPOs.

nse_upcoming_ipos

Upcoming IPOs.

nse_past_ipos

Past IPOs with a date range.

nse_ipo_details

Detailed IPO information.

nse_block_deals

Block deals data.

nse_bulk_deals

Bulk deals data.

nse_holidays

Market holidays for trading and clearing.

nse_list_indices

All NSE indices.

nse_list_stocks_by_index

Stocks contained in a specific index.

nse_list_etf

All NSE ETFs.

nse_list_sme

All NSE SME stocks.

nse_list_sgb

All Sovereign Gold Bonds.

nse_equity_meta_info

Metadata for NSE equity symbols.

nse_download_equity_bhavcopy

Equity bhavcopy reports.

nse_download_delivery_bhavcopy

Delivery bhavcopy reports.

nse_download_indices_bhavcopy

Indices bhavcopy reports.

nse_download_fno_bhavcopy

F&O bhavcopy reports.

bse_quote

Real-time stock quotes by scrip code on BSE.

bse_quote_weekly_hl

52-week and monthly high/low data for BSE.

bse_gainers

Top gainers on BSE with optional group/index filtering.

bse_losers

Top losers on BSE with optional group/index filtering.

bse_advance_decline

Advance/decline values for all BSE indices.

bse_near_52week

Stocks near 52-week high/low on BSE.

bse_index_historical

Historical index data for BSE (daily/weekly/monthly).

bse_all_indices_by_date

All BSE indices data for a specific date.

bse_corporate_actions

Corporate actions with advanced filtering on BSE data.

bse_announcements

Corporate announcements with categories on BSE.

bse_result_calendar

Corporate result calendar for BSE.

bse_lookup_symbol

Search by name, symbol, ISIN, or scrip code on BSE.

bse_get_scrip_name

Get symbol name from scrip code on BSE.

bse_get_scrip_code

Get scrip code from symbol name on BSE.

bse_list_securities

List securities with industry or group filters on BSE.

bse_download_bhavcopy

Daily bhavcopy reports for BSE.

bse_download_delivery

Daily delivery reports for BSE.

bse_fetch_index_names

List all BSE indices.

bse_fetch_index_metadata

Index report metadata for BSE.

download_document

Download and extract documents (PDFs, text, compressed files).

read_document_pages

Read specific pages from cached or new documents.