Pakistan Stock Exchange in plain English — quotes, dividends, announcements, and indices.
MCPpedia last refreshed this data
io.github.revolutionarybukhari/psx-mcp is an MCP server that pakistan Stock Exchange in plain English — quotes, dividends, announcements, and indices. Its tool list has not been published yet over stdio, sse and http, requires no API key, and scores 78/100 on MCPpedia's security, maintenance and efficiency rubric.
Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"psx": {
"args": [
"psx-mcp"
],
"command": "uvx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Talk to the Pakistan Stock Exchange in plain English.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
uvx 'psx-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked psx-mcp against OSV.dev.
Click any tool to inspect its schema.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in finance
OKX trading MCP server — connect AI agents to spot, swap, futures, options & grid bots via the Model Context Protocol.
Real-time financial market data: stocks, forex, crypto, commodities, and economic indicators
Deploy and manage blockchain nodes across 70+ protocols, search docs, request testnet funds.
Your AI agent, fluent in Australian tax. MCP server with cited answers from 34,500+ ATO documents, the income tax and GST Acts and 4,900+ rulings, plus deduction, depreciation, BAS and audit-risk tools that know your tax profile.
MCP Security Weekly
Get CVE alerts and security updates for io.github.revolutionarybukhari/psx-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
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:
"What are the upcoming dividends on PSX with payouts above 100%?"
"Should I buy MEBL today to collect the dividend?"
"Pull recent announcements for OGDC and summarize anything material."
"How has FFC's dividend history looked over the past 5 years?"
The LLM picks the right tools automatically and answers in your language.
Existing PSX tools are libraries — you import them, write code, get data. MCP servers are tools an LLM calls for you. You ask in English, the model invokes get_quote, get_upcoming_dividends, get_dividend_history, and synthesizes an answer. No Python required for the end user.
This is also the first PSX MCP server published. If you're building agents, financial copilots, or AI-augmented research workflows for Pakistani markets, this gives them eyes.
| Tool | What it does |
|---|---|
get_quote(symbol) | Current price snapshot for a symbol |
get_upcoming_dividends(symbol?) | Payouts table, optionally filtered, with computed buy deadlines |
get_buy_deadline(symbol) | Last day to buy and still collect the dividend (T+2 settlement) |
get_dividend_history(symbol, years) | Historical payouts |
get_announcements(symbol?, limit) | Recent corporate filings + PDF links |
search_symbols(query) | Fuzzy match company names → tickers |
get_indices() | KSE100, KSE30, KMI30, ALLSHR, PSXDIV20, etc. |
get_market_status() | Is PSX open right now? When does it open next? |
screen_dividend_stocks(min_payout_pct) | Filter upcoming dividends by payout size |
psx://market-statuspsx://indicespsx://upcoming-dividendsanalyze_dividend_play(symbol) — full dividend-trade analysisportfolio_review(symbols) — review a holdings listfind_dividend_opportunities(min_payout_pct) — screener + per-name analysisRequires Python 3.10+.
# From PyPI (once published)
pip install psx-mcp
# Or with uv (recommended)
uv tool install psx-mcp
# From source
git clone https://github.com/revolutionarybukhari/psx-mcp
cd psx-mcp
pip install -e .
Edit your Claude Desktop config:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"psx": {
"command": "uvx",
"args": ["psx-mcp"]
}
}
}
Restart Claude Desktop. You should see the PSX tools listed in the connection icon. Try:
"What dividends are coming up this week on PSX?"
Settings → MCP → add server:
{
"mcpServers": {
"psx": {
"command": "psx-mcp",
"args": []
}
}
}
For shared/team use or hosted agents:
psx-mcp --transport http --host 0.0.0.0 --port 8000
The server is then reachable at http://localhost:8000/mcp. Test it with the [MCP Inspector