CeylonCharts MCP Server

← Back to CeylonCharts

CeylonCharts MCP Server

CeylonCharts runs a hosted Model Context Protocol (MCP) server that gives AI assistants direct access to Colombo Stock Exchange (CSE) market data. Connect it once to Claude, ChatGPT or another MCP-capable client, then ask questions in plain language — the assistant fetches prices, history, financial statements and screener results from CeylonCharts instead of guessing.

Server details

https://mcp.ceyloncharts.com/mcp/
  • Sign-in: you log in with your CeylonCharts account through an OAuth flow when you connect. A free Basic account works; usage limits depend on your plan (see Limits).
  • Type: a remote (HTTP) MCP server. Nothing to install or run locally for Claude on the web or ChatGPT.
  • Data: CSE symbols, prices, financial statements, announcements, indices, technicals and macro series — see the tool list.

Connect from Claude

  1. In Claude on the web (claude.ai), open your Profile in the left sidebar, then Settings → Connectors, click + and choose Add custom connector.
  2. Paste the server URL above.
  3. Complete the CeylonCharts sign-in when prompted. Claude stores and refreshes the access token for you.
  4. In a conversation, click + in the message box, open Connectors and make sure CeylonCharts is switched on.
  5. Ask about a CSE stock. The tools in the list below appear as available tools once connected.

On a Team or Enterprise plan, an Owner adds it once under Organization Settings → Connectors → Add → Custom, and members then connect individually from their own Connectors panel.

Connect from ChatGPT

ChatGPT connects to remote MCP servers through Developer Mode, which OpenAI currently offers in beta on the web for Plus, Pro, Business, Enterprise and Education plans. Business and Enterprise workspaces may need an admin to approve it first. OpenAI changes these menus from time to time, so if a name below has moved, look for the same option nearby.

  1. Go to Settings → Security and login and switch on Developer mode.
  2. Go to Settings → Plugins (or open chatgpt.com/plugins) and click + to create a new developer-mode app.
  3. Fill in the form: Name "CeylonCharts", a short Description, MCP server URL as above, and Authentication: OAuth.
  4. Click Create, then complete the CeylonCharts sign-in when prompted.
  5. In a conversation, click + in the message box and add the CeylonCharts connector.

Other clients

Any client that supports remote MCP servers with OAuth can use the same URL. Setup notes for Google Antigravity, Claude Desktop (which uses a small local bridge) and plain HTTP calls are in the getting started guide. If you would rather call the data from your own code, the same data is available through a REST API with API keys — see the authentication guide.

What you can ask

  • “What is the RS rating and 52-week range for JKH.N0000?” get_technicals
  • “Which stocks are above their 200-day EMA with an RS rating over 80?” screen_stocks
  • “Show the latest quarterly income statement for COMB.N0000.” get_financial_statement
  • “What has HNB announced recently?” get_announcements
  • “Who are the top 20 shareholders of John Keells?” get_top20_shareholders
  • “What were today’s biggest gainers and losers?” get_market_summary
  • “Draw a candlestick chart of the ASI.” get_chart

Tools

The server exposes seventeen tools. Your assistant chooses which to call; you don’t need to name them.

Tool What it returns
get_symbolsList and search CSE-listed companies
get_quotesLive price snapshot for one or more stocks, or every CSE stock at once
get_ohlc_dataDaily, weekly or monthly OHLC price history, with corporate-action adjustments
get_chartCandlestick and volume chart image (PNG) for a CSE symbol
get_technicalsPre-computed daily technicals — moving averages, RS rating, 52-week range — for a stock or index
screen_stocksScreen CSE stocks by trend, RS rating, 52-week range and volume
screen_indicesScreen sector and headline indices by trend and RS rating
get_market_summaryDaily, weekly or monthly overview: top gainers and losers, activity leaders, index and sector performance
get_indicesList CSE market and sector indices (ASPI, S&P SL20, industry sub-indices)
get_index_dataHistorical data for a market or sector index
get_financial_statementFull income statement, balance sheet or cash flow statement detail
get_announcementsGeneral CSE disclosures: board changes, AGM/EGM notices, suspensions and more
get_corporate_actionsCorporate-actions calendar: dividends, rights issues, share splits
get_foreign_holdingsDaily foreign-shareholding percentage series for a symbol
get_top20_shareholdersRanked top-20 shareholder list for a company, by quarter
get_macro_seriesList the available macroeconomic series
get_macro_dataMacroeconomic indicator data

Full input and output shapes are in the MCP tools reference.

Limits and data

Requests are limited per account over a rolling one-hour window, depending on your plan. MCP tool calls and direct REST API calls share the same allowance.

Plan Requests per hour
Basic20
Pro100
Business10,000

These are the limits published in the rate limits guide, which is the place to check for current values. Upgrading your plan raises the limit immediately.

Market data comes from public Colombo Stock Exchange sources and third parties, and may be delayed or contain errors. Everything the server returns is for information only and is not investment advice — see the Terms of Service, and the methodology for how ratings and indicators are calculated.

Documentation and listings

Questions or a connection that won’t work? The About page has our contact details.