cse-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Live data from the Colombo Stock Exchange (CSE), Sri Lanka, via the public cse.lk API.
Prices and values are in Sri Lankan Rupees (LKR). Times are Sri Lanka time (UTC+05:30).
Regular trading: Monday-Friday 09:30-14:30, excluding market holidays.
Symbols look like JKH.N0000 (N = voting, X = non-voting). Bare tickers like "JKH" are treated as JKH.N0000.
If you don't know a symbol, use list_stocks with a name fragment (e.g. "bank", "keells").
Start with get_market_overview for "how's the market?" questions.
This is market data, not investment advice. Mention the data timestamp when it matters.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_market_overviewA | Snapshot of the whole market right now: open/closed status, the ASPI and S&P SL20 indices (value, change, day range) and today's turnover, volume and trades. Best first call for "how is the market doing?". |
| get_top_moversB | Today's biggest gainers, biggest losers, or most actively traded stocks. |
| list_stocksA | Search and rank every listed stock with today's prices. |
| get_sector_indicesA | All CSE sector indices (S&P/CSE industry groups such as Banks, Energy,
Capital Goods) with today's value, change and activity, best performers first.
The |
| get_market_daily_summaryB | End-of-day style market statistics: turnover, foreign vs domestic buying and selling (net foreign flow), market cap, market P/E, P/BV and dividend yield, number of companies traded. |
| get_stockA | Full live profile of one stock: price and change, today's range and
volume, week/month/YTD/52-week/all-time highs and lows, market cap,
foreign holding, beta. |
| get_price_historyA | Price history for one stock. period: "today" (15-minute bars), "1w",
"1m", "3m" or "1y" (daily bars). Includes a start/end/change/high/low
summary. Long series are thinned to |
| get_trades_by_priceA | Today's trading in one stock broken down by price level: how many shares and trades went through at each price, plus the volume-weighted average price (VWAP). Useful for spotting where the real buying/selling happened. |
| get_index_historyA | History of a market or sector index. |
| get_announcementsA | Latest CSE announcements, newest first. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Most tools target clearly different query shapes: market snapshot, stock profile, stock/index histories, price-level trades, and announcements. get_top_movers overlaps somewhat with list_stocks sorted by change/volume, and get_market_overview is related to get_market_daily_summary, but the descriptions give clear routing cues.
All tool names use consistent snake_case verb_noun naming, overwhelmingly get_* plus one appropriately named list_stocks. The convention is predictable and resource-oriented.
Ten tools is well-scoped for a CSE market-data server, with each tool covering a distinct view such as market overview, stock search, index history, or announcements. There is no obvious filler or missing basic surface.
The surface covers core market workflows: overview, movers, stock search, stock profiles, price and index history, trades by price, daily statistics, and announcements. Minor gaps remain around order-book/depth data and deeper company fundamentals, but agents can work around them.