MCP Server
HKEx Filings
io.github.simonmak-ascent/hkex-filings
What this MCP does
Searches, filters, and reads live Hong Kong Stock Exchange regulatory filings and their extracted text and tables.
Capabilities
Tools
4
tools
get_filing
Read HKEx Filing
Download 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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'required': ['link'], 'properties': {'link': {'type': 'string', 'description': 'HKEx document URL from a search_filings result (host www1.hkexnews.hk)'}, 'query': {'type': 'string', 'description': 'Optional text to find in the whole document; returns matches with offsets instead of a text window'}, 'offset': {'type': 'integer', 'default': 0, 'minimum': 0, 'description': 'Character offset where the returned text window starts (use next_offset to page)'}, 'extract': {'type': 'boolean', 'default': True, 'description': 'Extract text and tables; false returns size and content type only'}, 'max_chars': {'type': 'integer', 'default': 300000, 'maximum': 300000, 'minimum': 1, 'description': 'Maximum characters of document_text to return in this window'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'object', 'required': ['link', 'size_bytes'], 'properties': {'link': {'type': 'string'}, 'query': {'type': 'string'}, 'offset': {'type': 'integer'}, 'tables': {'type': 'array', 'items': {'type': 'object'}}, 'matches': {'type': 'array', 'items': {'type': 'object', 'required': ['offset', 'snippet'], 'properties': {'offset': {'type': 'integer'}, 'snippet': {'type': 'string'}}}}, 'size_bytes': {'type': 'integer'}, 'match_count': {'type': 'integer', 'description': 'Total matches for query'}, 'next_offset': {'type': ['integer', 'null'], 'description': 'Offset of the next window, or null at the end'}, 'text_length': {'type': 'integer', 'description': 'Characters in this window'}, 'content_type': {'type': 'string'}, 'document_text': {'type': 'string', 'description': 'Extracted Markdown text'}, 'tables_omitted': {'type': 'integer'}, 'text_truncated': {'type': 'boolean', 'description': 'True when more text follows this window'}, 'total_text_length': {'type': 'integer', 'description': 'Characters in the whole extracted document'}}, 'description': 'The downloaded document, with text and tables when extract is true.'}}}
get_server_info
Gateway Info
Report this live gateway's version, transport, and hard limits. Reads nothing.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'required': [], 'properties': {}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'object', 'properties': {'live': {'type': 'boolean'}, 'name': {'type': 'string'}, 'tools': {'type': 'array', 'items': {'type': 'string'}}, 'limits': {'type': 'object'}, 'filters': {'type': 'array', 'items': {'type': 'string'}}, 'storage': {'type': 'string'}, 'version': {'type': 'string'}, 'read_only': {'type': 'boolean'}, 'transport': {'type': 'string'}, 'extraction': {'type': 'object'}}, 'description': 'Gateway version, transport, tool list, filters, and hard limits.'}}}
list_filing_facets
Browse Filing Facets
Browse 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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'required': ['from_date', 'to_date'], 'properties': {'to_date': {'type': 'string', 'description': 'YYYY-MM-DD or DD/MM/YYYY'}, 'from_date': {'type': 'string', 'description': 'YYYY-MM-DD or DD/MM/YYYY'}, 'stock_code': {'type': 'string', 'description': 'Optional exact HKEx stock code to narrow the facets'}, 'max_results': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum filings to scan (default 50, cap 200)'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'object', 'required': ['from', 'to', 'count'], 'properties': {'to': {'type': 'string', 'description': 'Window end, YYYY-MM-DD'}, 'from': {'type': 'string', 'description': 'Window start, YYYY-MM-DD'}, 'count': {'type': 'integer', 'description': 'Filings scanned'}, 'categories': {'type': 'array', 'items': {'type': 'object', 'required': ['value', 'count'], 'properties': {'count': {'type': 'integer', 'description': 'Filings carrying this value'}, 'value': {'type': 'string', 'description': 'The category, file type, or stock code'}}}}, 'stock_codes': {'type': 'array', 'items': {'type': 'object', 'required': ['value', 'count'], 'properties': {'count': {'type': 'integer', 'description': 'Filings carrying this value'}, 'value': {'type': 'string', 'description': 'The category, file type, or stock code'}}}}, 'document_types': {'type': 'array', 'items': {'type': 'object', 'required': ['value', 'count'], 'properties': {'count': {'type': 'integer', 'description': 'Filings carrying this value'}, 'value': {'type': 'string', 'description': 'The category, file type, or stock code'}}}}, 'total_reported': {'type': ['integer', 'null']}, 'stock_code_filter': {'type': 'string'}, 'distinct_categories': {'type': 'integer'}, 'distinct_stock_codes': {'type': 'integer'}, 'distinct_document_types': {'type': 'integer'}}, 'description': "Counts of the window's categories, document types, and stock codes."}}}
search_filings
Search HKEx Filings
Search 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.
Read only
Open world
Idempotent
Input schema
{'type': 'object', 'required': ['from_date', 'to_date'], 'properties': {'to_date': {'type': 'string', 'description': 'YYYY-MM-DD or DD/MM/YYYY'}, 'category': {'type': 'string', 'description': 'Optional case-insensitive substring of the headline category'}, 'from_date': {'type': 'string', 'description': 'YYYY-MM-DD or DD/MM/YYYY'}, 'stock_code': {'type': 'string', 'description': 'Optional exact HKEx stock code, e.g. 01461'}, 'stock_name': {'type': 'string', 'description': 'Optional case-insensitive substring of the stock short name'}, 'max_results': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Maximum filings to fetch and return (default 50, cap 200)'}, 'title_query': {'type': 'string', 'description': 'Optional case-insensitive substring of the filing title'}, 'document_type': {'type': 'string', 'description': 'Optional exact file type, e.g. PDF, HTML, XLS, DOC'}}, 'additionalProperties': False}
Output schema
{'type': 'object', 'required': ['result'], 'properties': {'result': {'type': 'object', 'required': ['from', 'to', 'count', 'filings'], 'properties': {'to': {'type': 'string', 'description': 'Window end, YYYY-MM-DD'}, 'from': {'type': 'string', 'description': 'Window start, YYYY-MM-DD'}, 'count': {'type': 'integer', 'description': 'Filings returned'}, 'filings': {'type': 'array', 'items': {'type': 'object', 'required': ['stockCode', 'title', 'link'], 'properties': {'date': {'type': 'string', 'description': 'Release date, DD/MM/YYYY'}, 'link': {'type': 'string', 'description': 'HKEx document URL'}, 'title': {'type': 'string'}, 'newsId': {'type': 'string', 'description': 'HKEx news id'}, 'category': {'type': 'string', 'description': 'HKEx headline category'}, 'fileType': {'type': 'string', 'description': 'PDF, HTML, XLSX, ...'}, 'sizeText': {'type': 'string', 'description': 'HKEx-reported size, e.g. 53KB'}, 'stockCode': {'type': 'string'}, 'stockName': {'type': 'string'}}}, 'description': 'One entry per filing'}, 'filters': {'type': 'object', 'description': 'The filters applied'}, 'total_reported': {'type': ['integer', 'null'], 'description': 'HKEx-reported total for the window, when known'}}, 'description': 'The filings matching the window and filters.'}}}
History
Recent tool changes
Added
get_filing
Oct. 4, 2026, 2:40 a.m.
Added
list_filing_facets
Oct. 4, 2026, 2:40 a.m.
Added
search_filings
Oct. 4, 2026, 2:40 a.m.
Added
get_server_info
Oct. 4, 2026, 2:40 a.m.
Discover
Similar MCP servers
The Stall
ai.intuitek.the-stall/the-stall
Provides pay-per-call tools for YouTube keyword research and research on stocks, crypto, DeFi, options, and macroeconomic data.
AI 代理人任務中樞
com.penguindriver/hub
Aggregates Taiwan-focused tools for AI service comparisons, cryptocurrency data, game information, health guidance, and other con…
Valuein — SEC EDGAR Fundamentals & Smart-Money Data
io.github.valuein/mcp-sec-edgar
Provides point-in-time SEC EDGAR fundamentals, filings, ownership signals, financial analysis, valuation models, research reports…
equibles
io.github.daniel3303/equibles
Provides equity and market research tools covering SEC filings, company financials, portfolios, prices, options, macroeconomic da…
tollbooth
io.github.huwhitememes/tollbooth
Provides paid OSINT, web intelligence, security threat and vulnerability lookups, prediction-market analysis, financial data, leg…
World Monitor
app.worldmonitor/mcp
Delivers live geopolitical, conflict, country-risk, market, energy, climate, aviation, supply-chain, and macroeconomic intelligen…
EventTrader Research (read-only)
com.cymetica/event-trader-research
Offers read-only research on funds, event markets, order books, arena markets, crypto pools, backtests, and related financial ana…
Slacking.biz — SEC Financial Data + US Economics + Demographics + FX
io.github.Th3Slack3r/slacking-biz
Provides financial, economic, demographic, foreign-exchange, regulatory, and company research data from public sources.