# CSE Market Data

> CSE Market Data is an open-source MCP server for finance and payments. Live Colombo Stock Exchange prices, indices, sectors and announcements for Claude. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux
- **Repository:** https://github.com/lxnid/cse-mcp
- **MCP Registry name:** io.github.lxnid/cse-mcp
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

cse-mcp connects an assistant to the public data behind cse.lk so answers use current Sri Lankan market figures instead of pasted numbers. It runs on your own computer, fetches from the exchange's API, and tidies results with readable names, rounded numbers, Sri Lanka time and a 30-second cache.

Ten read-only tools cover market status and the ASPI and S&P SL20 indices, top movers, stock search, a full profile for one stock, price history, volume at each price level with VWAP, sector indices, index history, daily foreign versus local flow with market P/E and yield, and company announcements such as dividends and financial statement links. Tickers are forgiving, so jkh, JKH and JKH.N0000 all work.

The README points out it is unofficial, that cse.lk's API is public but undocumented and may change, that data can be delayed or wrong, and that it is not financial advice. Prices are in LKR, and trading runs Monday to Friday, 09:30 to 14:30.

## Features

- **Market overview:** Open or closed status, ASPI, S&P SL20 and turnover.
- **Top movers:** Gainers, losers and most active stocks.
- **Stock profiles:** Price ranges, market cap, foreign holding and beta.
- **Price history:** Intraday bars through one year.
- **Sector indices:** All sector indices ranked best to worst.
- **Announcements:** Dividends, results, circulars and notices.

## Good for

- Get a daily market wrap for Colombo
- Check whether foreigners were net buyers
- Compare a bank stock with the banks index
- Summarise new quarterly results
- See where a stock traded most of its volume

## Install

### Claude Code (Terminal)

```sh
claude mcp add cse-mcp -- uvx cse-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "cse-mcp": {
      "command": "uvx",
      "args": [
        "cse-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "cse-mcp": {
      "command": "uvx",
      "args": [
        "cse-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "cse-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "cse-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "cse-mcp": {
      "command": "uvx",
      "args": [
        "cse-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "cse-mcp": {
      "command": "uvx",
      "args": [
        "cse-mcp"
      ]
    }
  }
}
```

## Tools

- `get_market_overview`: Market status, ASPI and S&P SL20, turnover, volume and trades.
- `get_top_movers`: Top gainers, losers or most active stocks.
- `list_stocks`: Search listed stocks and sort by turnover, change or market cap.
- `get_stock`: Full profile of one stock.
- `get_price_history`: Price history from intraday to one year.
- `get_trades_by_price`: Today's volume at each price level, plus VWAP.
- `get_sector_indices`: Every sector index, best to worst.
- `get_index_history`: History for ASPI, S&P SL20 or a sector index.
- `get_market_daily_summary`: Foreign versus local buying, market P/E, P/BV and dividend yield.
- `get_announcements`: Dividends, financial statements, circulars and notices.

## FAQ

### Can it place trades?

No. All tools are read-only.

### How do I install it in Claude Desktop?

Download the .mcpb file from the latest release and double-click it.

### Is it official?

No. It is unaffiliated with the Colombo Stock Exchange.

### Does it work in claude.ai on the web?

Not directly, because it runs locally; you can host it over HTTPS and add it as a custom connector.

### Is CSE Market Data free?

Yes. CSE Market Data is open source, so you can use and self-host it for free.

### How do I add CSE Market Data to Claude Code?

Run this command in your terminal: claude mcp add cse-mcp -- uvx cse-mcp

### What are the best alternatives to CSE Market Data?

The closest alternatives to CSE Market Data are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/cse-market-data
