PSX MCP
Pakistan Stock Exchange in plain English — quotes, dividends, announcements, and indices.
Versions
0.1.1latestTools 9
get_quote Get the current price quote for a PSX-listed symbol. Args: symbol: PSX ticker, e.g. "MEBL", "OGDC", "FFC", "ENGRO". Returns last price, change, change %, volume, day high/low, open, prev close. Data is delayed by 5 minutes per PSX Data Portal.
get_upcoming_dividends List upcoming dividend payouts on PSX. Args: symbol: Optional PSX ticker to filter. If omitted, returns all upcoming payouts in the table. Each result includes book closure dates, AGM date, payout amount/type, and the computed buy deadline (T+2 settlement) — the last day you can buy and still be entitled to the dividend.
get_buy_deadline For a symbol with an upcoming dividend, return the last day you can buy and still be entitled to the dividend (T+2 settlement applied). Returns 'no upcoming dividend' if the symbol isn't currently in the PSX payouts table.
get_dividend_history Get historical dividend payouts for a symbol. Args: symbol: PSX ticker. years: How many years of history to return (default 5).
get_announcements Get recent corporate announcements from PSX. Args: symbol: Optional ticker filter (e.g. only OGDC announcements). limit: Max rows to return (default 20, cap 100). Each item includes date, symbol, title, and a PDF link to the original notice.
search_symbols Fuzzy search PSX symbols and company names. Useful when the user names a company casually ("habib bank" -> "HBL", "fauji fertilizer" -> "FFC").
get_indices Get current values for major PSX indices: KSE100, KSE30, ALLSHR, KMI30, KMIALLSHR, PSXDIV20, BKTI, OGTI, MII30.
get_market_status Is PSX open right now? Returns OPEN / PRE_OPEN / CLOSED_TODAY / WEEKEND plus the next market open in PKT.
screen_dividend_stocks Screen the upcoming-payouts table by payout size. Args: min_payout_pct: Minimum payout % to include (e.g. 50 = 50% of par). PSX payouts are quoted as % of face value (typically Rs 10). limit: Max results. NOTE: This is a payout-size filter, not a true dividend-yield screen (yield = dividend / current price). For real yield you'd cross-reference each symbol's current price — call get_quote() per symbol if needed.
Permissions 1
network medium