
HKEx Filings MCP server
online · 96% uptimeLive HKEx (Hong Kong Stock Exchange) regulatory filings for AI agents.
16 stars110 downloads/wk
Reviews
Write oneNobody has reviewed HKEx Filings yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
HKEx Filings tools (4)
write = sends, deletes, buys or postsget_filingFreeDownload one HKEx document by its URL and read, page through, or search its text. ``link`` must be an HKEx document URL from search_filings (host ``www1.hkexnews.hk``); any other host is rejected. With ``extract=True`` (default) the response includes up to 30 ``tables`` and a window of extracted ``document_text``: ``max_chars`` characters starting at ``offset``. Long reports return ``next_offset``; call again with it to read the next window. Pass ``query`` to search the whole document instead: the response then lists up to 20 case-insensitive matches with their offsets and surrounding text, plus ``match_count`` — use a match offset to read that part. Set ``extract=False`` for size and content type only.
get_server_infoFreeReport this live gateway's version, transport, and hard limits. Reads nothing.
list_filing_facetsFreeBrowse what filings exist in a date window (at most 31 days) without downloading. ``from_date``/``to_date`` accept YYYY-MM-DD or DD/MM/YYYY. Returns counts of the categories (headline categories), document types, and stock codes present in the window, each sorted by frequency and capped at 50 values, plus the distinct counts. Optionally narrow to one ``stock_code``. Use this to discover valid filter values before calling search_filings; it fetches the window once and extracts no document text.
search_filingsFreeSearch live HKEx filings in a date window (at most 31 days). ``from_date``/``to_date`` accept YYYY-MM-DD or DD/MM/YYYY. All filters are optional and combine with AND semantics: ``stock_code`` matches exactly (e.g. ``01461`` or ``1461``); ``title_query``, ``category`` and ``stock_name`` are case-insensitive substrings (e.g. category ``Dividend``); ``document_type`` matches the file type exactly (e.g. ``PDF`` or ``HTML``). Filters are applied to the fetched window, so widen ``max_results`` to catch rarer matches. ``max_results`` caps the number of filings fetched and returned (hard cap 200). Returns the matching filings — each carrying ``fileType``, ``sizeText``, ``category`` and ``newsId`` metadata — plus the HKEx-reported total for the window. Use list_filing_facets first to see which categories, types and codes exist in a window.
Public scan report
scanner v0.1.10 · 2026-10-14 · same rubric, same numbers if you re-run it
- Code scan47 source files scanned25/25
- Live reliabilityremote reachable in 2077ms17/20
- Tool poisoning4 tool descriptions checked15/15
- Auth qualityopen endpoint, read-only tools10/15
- Maintenancelast push 0 days ago15/15
- Maintainer identityendpoint served from the registry-verified namespace domain8/10
How HKEx Filings compares
Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 90/100
- higher than 92% of 1,675 Finance servers
- Tools
- 4
- the typical Finance server has 9
- Tools that change things
- 0%
- typical: 0%. Fewer write tools means less an agent can break
- Uptime
- 96%
- of our recent checks; the typical remote Finance server answers 100%
- Response time
- 1,118 ms
- faster than 9% of 1,054 Finance servers
- GitHub stars
- 16
- more than 90% of 906 Finance servers
- Downloads a week
- 110
- more than 75% of 379 Finance servers with a package
What its tools let an agent do: 4 read
Install HKEx Filings in Claude Code, Cursor or VS Code
claude mcp add --transport http hkex-filings https://hkex-listco-updates.ascent-partners.com/api/mcp
What the publisher says
From the HKEx Filings repository's README, as published. We do not edit it. Read it on GitHub
HKEx Filing Scraper
<!-- mcp-name: com.ascent-partners/hkex-filings -->
An open-source scraper for 25+ years of HKEx regulatory filings — into any of nine databases, with full-text extraction, graph linking, and a read-only MCP server for AI agents.
Overview
The US has EDGAR full-text search. Japan has EDINET. Hong Kong has a search form that returns one page at a time. There is no bulk, machine-readable, full-text corpus of HKEx filings. This builds one.
An open-source Python tool that scrapes 25+ years of Hong Kong Stock Exchange (HKEx) regulatory filings and ingests them into any combination of nine databases — with full-text and table extraction, chunk-level coverage, optional graph linking, and a read-only MCP server so AI agents can query the corpus or the live site.
<!-- mcp-name: com.ascent-partners/hkex-filings -->
It speaks the undocumented HKEx JSON API directly, which is faster and more resilient than driving a browser.
Vendors & Integrations
Databases — nine first-class destinations, in documented popularity order (see the support matrix):
- PostgreSQL — production-grade open-source relational
- MySQL / MariaDB — GPL relational servers, one driver
- SQLite — zero-server file database, no install needed
- MongoDB — document database
- Neo4j — property-graph database
- ClickHouse — columnar analytics engine
- DuckDB — in-process analytical engine
- SurrealDB — multi-model graph + document database
AI clients — any MCP-capable agent; ready-made configuration for Claude, ChatGPT, Cursor, VS Code/Copilot, Gemini CLI, opencode, Manus, and Perplexity.
Available on — PyPI · Glama · MCP Registry · hosted gateway.
Two Ways to Use It
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
HKEx Filings: common questions
- Is HKEx Filings MCP server safe?
- Yes, by our scan: it is graded A (90/100). Read the HKEx Filings safety report
- How do I install HKEx Filings?
- It runs remotely at hkex-listco-updates.ascent-partners.com. Add it to Claude Code, Cursor, VS Code or Claude Desktop with the snippets above, or call it through the mcp.market gateway without installing anything.
- Does HKEx Filings need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is HKEx Filings maintained?
- The last commit was 11 days ago (2026-10-14). The latest release is v2.4.3.
- Is HKEx Filings up?
- 96% of our last 28 checks got an answer. We check remote servers about four times a day.
- What can I use instead of HKEx Filings?
- Servers from other publishers that do the same job: Tapetide - Indian Stock Market MCP server, Torus MCP server and Yahoo Finance MCP server.
- How does HKEx Filings compare with other Finance MCP servers?
- safety score 90/100 (higher than 92% of 1,675 Finance servers); tools 4 (the typical Finance server has 9); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to HKEx Filings
Same job from other publishers: the closest match first, then the best rated.
- Tapetide - Indian Stock Market MCP55 tools for Indian stock markets — NSE & BSE quotes, screener, filings, FII/DII, optionsnot reviewedEstablishedA
- TorusStock research memory for Claude: theses, sourced claims and SEC filing alerts in a local graphnot reviewedGrowingA
- Yahoo FinanceAccess Yahoo Finance stock data, news, screeners, options, financials, and charts through MCP.not reviewedEstablishedA
- Akshare OneMCP server that provides access to Chinese stock market data using akshare-onenot reviewedEstablishedA
- KronosStock price forecasting for China A-shares — Kronos K-line time-series modelnot reviewedEstablishedB