Nse Bse MCP

🚀 NSE-BSE MCP Server

This is a Model Context Protocol server for NSE and BSE India stock market APIs, which uses Streamable HTTP transport. It enables you to obtain real-time Indian stock market data and allows LLMs to conduct analysis for you.

🚀 Quick Start

You can start the server in the following two ways:

Using npx

npx nse-bse-mcp

Running from source

# Requires Bun: https://bun.sh
bun install
bun run build
bun start

🐳 Docker Deployment

cd docker
docker-compose up -d

The server will be accessible at http://localhost:3000/mcp

💻 MCP Client Setup (Gemini CLI, Claude Desktop, ChatGPT)

{
  "mcpServers": {
    "nse-bse-mcp": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "http://localhost:3000/mcp", "--allow-http"]
    }
  }
}

✨ Features

• 66 Tools (44 NSE + 20 BSE + 2 Document)
• Smart Response Limiting - For large responses, it returns metadata, enabling the LLM to decide what to fetch.
• Document Downloader - It can download and extract IPO prospectuses, reports, and circulars.
• Streamable HTTP transport (stateless)
• CORS support for browsers
• Health check endpoint
• Production ready

🛠️ Tools (66 Total)

NSE Tools (44)

Market Data (6 tools)

• nse_get_market_status - Retrieve the current market status and trading hours.
• nse_equity_quote - Get real-time equity quotes.
• nse_get_quote - Obtain quotes with segment specification (equities, sme, mf, debt).
• nse_lookup_symbol - Search for symbols by name or partial match.
• nse_get_gainers - Find the top gainers from market data.
• nse_get_losers - Locate the top losers from market data.

Historical Data (4 tools)

• nse_equity_historical - Get historical equity data within a specified date range.
• nse_index_historical - Retrieve historical index data.
• nse_fno_historical - Obtain historical F&O data.
• nse_vix_historical - Get historical VIX (volatility index) data.

Options & Derivatives (6 tools)

• nse_option_chain - Get the complete option chain for symbols.
• nse_filtered_option_chain - Obtain the option chain with strike range filtering.
• nse_compile_option_chain - Get the option chain for a specific expiry date.
• nse_calculate_max_pain - Calculate the max pain for options.
• nse_fno_lots - Find the F&O lot sizes for all symbols.
• nse_futures_expiry - Get the futures expiry dates.

Corporate Information (5 tools)

• nse_corporate_actions - Retrieve dividends, splits, and bonuses.
• nse_corporate_announcements - Get corporate announcements.
• nse_board_meetings - Obtain board meeting information.
• nse_annual_reports - Get company annual reports.
• nse_circulars - Retrieve NSE circulars.

IPO Tools (4 tools)

• nse_current_ipos - Find the current/ongoing IPOs.
• nse_upcoming_ipos - Get the upcoming IPOs.
• nse_past_ipos - Retrieve past IPOs within a specified date range.
• nse_ipo_details - Get detailed IPO information.

Market Activity (3 tools)

• nse_block_deals - Obtain block deals data.
• nse_bulk_deals - Get bulk deals data.
• nse_holidays - Retrieve market holidays (trading/clearing).

Lists & Metadata (6 tools)

• nse_list_indices - Get all NSE indices.
• nse_list_stocks_by_index - Find the stocks in a specific index.
• nse_list_etf - Get all ETFs.
• nse_list_sme - Get all SME stocks.
• nse_list_sgb - Get all Sovereign Gold Bonds.
• nse_equity_meta_info - Retrieve equity symbol metadata.

Download Tools (4 tools)

• nse_download_equity_bhavcopy - Download equity bhavcopy reports.
• nse_download_delivery_bhavcopy - Download delivery bhavcopy reports.
• nse_download_indices_bhavcopy - Download indices bhavcopy reports.
• nse_download_fno_bhavcopy - Download F&O bhavcopy reports.

BSE Tools (20)

Market Data (6 tools)

• bse_quote - Get real-time stock quotes by scrip code.
• bse_quote_weekly_hl - Obtain 52-week and monthly high/low data.
• bse_gainers - Find the top gainers with group/index filtering.
• bse_losers - Locate the top losers with group/index filtering.
• bse_advance_decline - Get the advance/decline values for all indices.
• bse_near_52week - Find the stocks near 52-week high/low.

Historical Data (2 tools)

• bse_index_historical - Retrieve historical index data (daily/weekly/monthly).
• bse_all_indices_by_date - Get all indices data for a specific date.

Corporate Information (3 tools)

• bse_corporate_actions - Retrieve corporate actions with advanced filtering.
• bse_announcements - Get corporate announcements with categories.
• bse_result_calendar - Obtain the corporate result calendar.

Search & Lookup (4 tools)

• bse_lookup_symbol - Search by name, symbol, ISIN, or scrip code.
• bse_get_scrip_name - Get the symbol name from the scrip code.
• bse_get_scrip_code - Get the scrip code from the symbol name.
• bse_list_securities - List securities with industry/group filters.

Report Downloads (2 tools)

• bse_download_bhavcopy - Download daily bhavcopy reports.
• bse_download_delivery - Download daily delivery reports.

Metadata (2 tools)

• bse_fetch_index_names - Get the list of all BSE indices.
• bse_fetch_index_metadata - Retrieve index report metadata.

Document Tools (2)

Document Processing (2 tools)

• download_document - Download and extract documents (PDFs, text, compressed files).
• read_document_pages - Read specific pages from cached or new documents.

All tools support Smart Response Limiting with max_items and fields parameters to handle large datasets efficiently.

📄 License

This project is licensed under the MIT license.