Package Exports

dse-stock-mcp
dse-stock-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (dse-stock-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

DSE Stock MCP Server

A very first MCP (Model Context Protocol) server that provides real-time and historical data for Dhaka Stock Exchange symbols, with a robust symbol resolver.

Features

Real-time Data: Get current stock prices and market data
Historical Data: Fetch OHLC data for any date range
Company News: Access latest news and announcements for any DSE-listed company
Symbol Resolution: Validates and normalizes inputs (codes, names, aliases) before hitting the API
Comprehensive Coverage: Support for all DSE-listed companies with robust symbol lookup

Available Tools

get_current_price(symbol) - Get real-time stock price and market data
get_historical_data(symbol, start_date, end_date) - Fetch historical OHLC data
get_company_news(symbol) - Get latest news and announcements for a company

Input Flexibility: All tools accept trading codes (e.g., GP, UNILEVERCL) or company names from the CSV.

Installation

Prerequisites:

Install Node.js LTS (includes npm and npx). Verify with:
- npx -v (npm 5.2+ includes npx)

Setup

Clone or download this repository
Install dependencies:
```
npm install
```
Build the project:
```
npm run build
```
Set your API key:
```
export DSE_STOCK_API_KEY="YOUR_API_KEY"
```

Usage

Running the Server

npm start

Development Mode

npm run dev:tsx

Claude-Desktop/Cursor Integration

Add this configuration to your .cursor/mcp.json (workspace) or ~/.cursor/claude_desktop_config (global):

{
  "mcpServers": {
    "dse-stock-mcp": {
      "command": "npx",
      "args": ["-y", "github:SambasBoyyyy/dse-stock-mcp"],
      "env": {
        "DSE_STOCK_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

Restart Claude-Desktop/Cursor to load the server.

API Key

You need a valid API key to use this server. Set the DSE_STOCK_API_KEY environment variable with your API key.

License

MIT License - see LICENSE file for details.