Skip to content
MCP server

CSE Market Data

Live Colombo Stock Exchange prices, indices, sectors and announcements for Claude

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About CSE Market Data

CSE Market Data is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

claude mcp add cse-mcp -- uvx cse-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "cse-mcp": {
      "command": "uvx",
      "args": [
        "cse-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "cse-mcp": {
      "command": "uvx",
      "args": [
        "cse-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (10)

Taken from the project documentation; the running server may differ.

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.

What it does

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

Pricing

Open source

MIT licence

CSE Market Data 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 to CSE Market Data

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments