Dse

PyPI Python CI License: MIT MCP

A production-grade Model Context Protocol (MCP) server for the Dhaka Stock Exchange (DSE) — live quotes, price history, fundamentals, order-book depth, news, technical indicators, screening — plus a bundled dse-analysis skill that teaches your agent a disciplined buy/sell workflow on top of those tools.

Data is scraped from dsebd.org (DSE's official site) with all of its production quirks handled: incomplete TLS chains, -- placeholders, comma-grouped numbers, invisible layout tables, market-hours-aware caching, and a mirror-domain fallback. Informational only — not investment advice. Not affiliated with DSE.

Install

Requires Python 3.12+ (or just uv/pipx, which manage Python for you).

# Register with Claude Code (recommended)
claude mcp add dse -s user -- uvx dse-mcp

{
  "mcpServers": {
    "dse": { "command": "uvx", "args": ["dse-mcp"] }
  }
}

pipx install dse-mcp
# then register with the command "dse-mcp"

docker run -i --rm ghcr.io/ofsazib/dse-mcp

The dse-analysis skill

The repo ships an agent skill that turns these tools into a repeatable buy/sell analysis workflow (market context → fundamentals → technicals → news → verdict with confidence + risks):

# from a git clone of this repo
./scripts/install_skill.sh              # installs to ~/.claude, ~/.agents, ~/.zcode
./scripts/install_skill.sh --dir ~/x    # add a custom skills directory
./scripts/install_skill.sh --uninstall  # remove from all configured directories

Or copy skills/dse-analysis/ into your client's skills directory manually.

Removing everything

claude mcp remove dse                    # unregister the MCP server (add -s user if needed)
./scripts/install_skill.sh --uninstall   # remove the skill from all skill directories
uv cache clean dse-mcp                   # drop uvx's cached build of the package

Tools (16)

Every response carries market_status (live/closed), data_freshness (live/snapshot/stale), and data_as_of — so closed-market data is never mistaken for live prices.

Market

Stock

Analysis & screening

Trading-hours aware caching

• Market live (Sun–Thu 10:00–14:50 Asia/Dhaka): data cached 30s (depth is always fetched fresh).
• Market closed: the last session's snapshot is cached ~1h and persisted to ~/.cache/dse-mcp/, so a restart still serves the last session (labeled snapshot).
• DSE unreachable: the persisted snapshot is served labeled stale.

Configuration (optional)

All via environment variables with the DSE_MCP_ prefix — see .env.example. Useful ones:

Troubleshooting

• [SSL: CERTIFICATE_VERIFY_FAILED] — dsebd.org serves an incomplete TLS chain. dse-mcp uses the OS trust store (truststore), which handles it; do not replace it with verify=False.
• Empty depth / quotes look frozen — the market is closed (or a holiday). Check market_status and the response's data_as_of.
• DGEN: null — the DGEN index is retired from DSE's live pages; null is the honest value.

Development

git clone https://github.com/ofsazib/dse-mcp && cd dse-mcp
uv sync                                   # Python 3.12 via uv
uv run pytest                             # 44 offline tests (recorded fixtures)
uv run ruff check .
uv run dse-mcp                            # run the server locally
npx @modelcontextprotocol/inspector uv run dse-mcp   # visual debugging

Re-record fixtures when dsebd.org markup changes: uv run python scripts/record_fixtures.py. Rebuild the instrument bundle: uv run python scripts/build_instruments.py. See AGENTS.md for architecture and CONTRIBUTING.md to contribute.

Legal

• Data source: dsebd.org (Dhaka Stock Exchange). This project is an independent, unaffiliated open-source client; data remains the property of DSE.
• Nothing here is investment advice. DSE securities can be illiquid and subject to circuit breakers; verify everything against primary sources before acting.

License

MIT © Omar Faruk Sazib