Model Context Protocol server for the Pakistan Stock Exchange — live quotes, EOD history, indices, fundamentals, dividends, and announcements as LLM-callable tools.
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"psx-mcp-server","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# psx-mcp-server [](https://github.com/ahmedraza-96/psx-mcp-server/actions/workflows/ci.yml) [](https://pypi.org/project/psx-mcp-server/) [](https://pypi.org/project/psx-mcp-server/) [](LICENSE) A [Model Context Protocol](https://modelcontextprotocol.io) server that gives Claude and other MCP agents live **Pakistan Stock Exchange** data — quotes, intraday and end-of-day history, indices (KSE-100 and 17 others), company fundamentals, dividends, and announcements — sourced from the public [PSX Data Portal](https://dps.psx.com.pk). No API key required. ## Quick start The server runs via [`uv`](https://docs.astral.sh/uv/) — `uvx` fetches and runs it in one step, so there is nothing to install manually. **Claude Code:** ```bash claude mcp add psx -- uvx psx-mcp-server ``` **Claude Desktop** — add to `claude_desktop_config.json` (macOS: `~/Library/Application Support/Claude/`, Windows: `%APPDATA%\Claude\`): ```json { "mcpServers": { "psx": { "command": "uvx", "args": ["psx-mcp-server"] } } } ``` **Any MCP client:** run `uvx psx-mcp-server` (stdio transport). Requires `uv` ([install guide](https://docs.astral.sh/uv/getting-started/installation/)). ## Example > **You:** Which PSX stocks gained the most today, and what's HBL trading at? The agent calls `get_market_snapshot` and `get_quote`, and answers: ``` TOP 5 GAINERS: TCORPR2 +22.62% Rs.5.42 PINL +10.52% Rs.10.51 HICL +10.05% Rs.11.50 TSPL +10.02% Rs.18.12 CLVL +10.02% Rs.22.41 breadth: 296 advancers / 180 decliners HBL: Habib Bank Limited | current Rs.318.15 | P/E 7.43 KSE100: 187,454.69 (+1.12%) ``` ## Tools | Tool | Parameters | Returns | |------|------------|---------…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.