revolutionarybukhari avatar

PSX MCP

revolutionarybukhari/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 tools

Public 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

CI PyPI Python License 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:


View the full README on GitHub

Details

Repository
github.com/revolutionarybukhari/psx-mcp
Website
github.com/revolutionarybukhari/psx-mcp
Package
psx-mcp
Transport
STDIO
Registry
MCP registry, active

More from revolutionarybukhari