
PSX MCP
Brings Pakistan Stock Exchange data into Claude Desktop, Cursor, or any MCP client as callable tools. Ask for upcoming dividends, get quote snapshots, pull corporate announcements with PDF links, or screen stocks by payout percentage. The server scrapes PSX's public data portal and handles T+2 settlement math to tell you the last day to buy before a dividend record date. It's stateless, runs over stdio or HTTP, and caches the symbol list for fast fuzzy search. Built for conversational research workflows where you want to ask "should I buy MEBL today to collect the dividend?" and get a structured answer without writing Python. Data delayed about five minutes, no order execution.
- GitHub stars
- 3
- tools
- 9
- transport
- STDIO
- last updated
- May 3, 2026
Tools
9 toolsPublic tool metadata for what this MCP can expose to an agent.
get_quoteCurrent price snapshot for a symbol
Current price snapshot for a symbol
No parameter schema in public metadata yet.
get_upcoming_dividendsPayouts table, optionally filtered, with computed buy deadlines
Payouts table, optionally filtered, with computed buy deadlines
No parameter schema in public metadata yet.
get_buy_deadlineLast day to buy and still collect the dividend (T+2 settlement)
Last day to buy and still collect the dividend (T+2 settlement)
No parameter schema in public metadata yet.
get_dividend_historyHistorical payouts
Historical payouts
No parameter schema in public metadata yet.
get_announcementsRecent corporate filings + PDF links
Recent corporate filings + PDF links
No parameter schema in public metadata yet.
search_symbolsFuzzy match company names → tickers
Fuzzy match company names → tickers
No parameter schema in public metadata yet.
get_indicesKSE100, KSE30, KMI30, ALLSHR, PSXDIV20, etc.
KSE100, KSE30, KMI30, ALLSHR, PSXDIV20, etc.
No parameter schema in public metadata yet.
get_market_statusIs PSX open right now? When does it open next?
Is PSX open right now? When does it open next?
No parameter schema in public metadata yet.
screen_dividend_stocksFilter upcoming dividends by payout size
Filter upcoming dividends by payout size
No parameter schema in public metadata yet.
Sponsors
Readme
psx-mcp
mcp-name: io.github.revolutionarybukhari/psx-mcp
Talk to the Pakistan Stock Exchange in plain English.
psx-mcp is a Model Context Protocol server that exposes PSX market data — quotes, dividends, announcements, indices — as tools any MCP-compatible AI client can call. Connect it to Claude Desktop, Cursor, ChatGPT, or your own agent, and ask questions like:
Details
- Repository
- github.com/revolutionarybukhari/psx-mcp
- Website
- github.com/revolutionarybukhari/psx-mcp
- Package
psx-mcp- Transport
- STDIO
- Registry
- MCP registry, active