psx-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_quoteA | 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_dividendsA | 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_deadlineA | 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_historyA | Get historical dividend payouts for a symbol. Args: symbol: PSX ticker. years: How many years of history to return (default 5). |
| get_announcementsA | 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_symbolsA | Fuzzy search PSX symbols and company names. Useful when the user names a company casually ("habib bank" -> "HBL", "fauji fertilizer" -> "FFC"). |
| get_indicesA | Get current values for major PSX indices: KSE100, KSE30, ALLSHR, KMI30, KMIALLSHR, PSXDIV20, BKTI, OGTI, MII30. |
| get_market_statusA | Is PSX open right now? Returns OPEN / PRE_OPEN / CLOSED_TODAY / WEEKEND plus the next market open in PKT. |
| screen_dividend_stocksA | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| analyze_dividend_play | Generate a thorough analysis prompt for a potential dividend-capture trade on the given PSX symbol. The LLM will call get_quote, get_upcoming_dividends, get_dividend_history, and get_announcements to gather data. |
| portfolio_review | Review a comma-separated list of PSX holdings. The LLM will pull current prices, upcoming dividends, and recent news for each. |
| find_dividend_opportunities | Find dividend trades worth investigating right now. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| resource_market_status | Current PSX trading status as JSON. |
| resource_indices | Snapshot of all major PSX indices as JSON. |
| resource_upcoming_dividends | All upcoming dividends with computed buy deadlines, as JSON. |
TDQS
Scored across 9 tools
Each tool targets a distinct aspect of PSX data: announcements, dividends (various forms), indices, market status, quotes, and symbol search. No two tools have overlapping purposes.
Most tools follow a 'get_' prefix (get_announcements, get_quote, etc.), but 'screen_dividend_stocks' and 'search_symbols' use different verbs. The pattern is mostly consistent with minor deviations.
Nine tools is well-scoped for a stock exchange data server, covering essential functions without being overly numerous or sparse.
The tool set covers quotes, indices, market status, dividends (history, upcoming, screening, buy deadline), announcements, and symbol search. Missing historical prices or detailed corporate actions, but adequate for typical queries.