HKEx Filings
simonmak-ascent/hkex-filing-scraper
Live HKEx (Hong Kong Stock Exchange) regulatory filings for AI agents.
- GitHub stars
- 16
- tools
- 4
- transport
- STDIO, HTTP
- last updated
- Oct 14, 2026
Install
From registry metadata$ npx add-mcp https://hkex-listco-updates.ascent-partners.com/api/mcp --name hkex-filingsRun in your terminal. add-mcp asks which agents to add it to (Claude Code, Codex, Cursor and more). Add -g to install it for every project.
Review the command, arguments and environment values before installing. MCP servers run with your local permissions.
Other ways
Claude Code
$ claude mcp add --transport http hkex-filings https://hkex-listco-updates.ascent-partners.com/api/mcpRun in your terminal. Add --scope user to make it available in every project.
Tools
Verified live · 4 toolsVerified live against the running server on Nov 6, 2026.
get_server_infoReport this live gateway's version, transport, and hard limits. Reads nothing.
Report this live gateway's version, transport, and hard limits. Reads nothing.
No parameters. Call it with no arguments.
search_filingsSearch 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 ``sto...8 params
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 ``sto...
Parameters* required
categorystringOptional case-insensitive substring of the headline category
document_typestringOptional exact file type, e.g. PDF, HTML, XLS, DOC
from_date*stringYYYY-MM-DD or DD/MM/YYYY
max_resultsintegerMaximum filings to fetch and return (default 50, cap 200)
stock_codestringOptional exact HKEx stock code, e.g. 01461
stock_namestringOptional case-insensitive substring of the stock short name
title_querystringOptional case-insensitive substring of the filing title
to_date*stringYYYY-MM-DD or DD/MM/YYYY
list_filing_facetsBrowse 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...4 params
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...
Parameters* required
from_date*stringYYYY-MM-DD or DD/MM/YYYY
max_resultsintegerMaximum filings to scan (default 50, cap 200)
stock_codestringOptional exact HKEx stock code to narrow the facets
to_date*stringYYYY-MM-DD or DD/MM/YYYY
get_filingDownload 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...5 params
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...
Parameters* required
extractbooleanExtract text and tables; false returns size and content type onlydefault: true
link*stringHKEx document URL from a search_filings result (host www1.hkexnews.hk)
max_charsintegerMaximum characters of document_text to return in this windowdefault: 300000
offsetintegerCharacter offset where the returned text window starts (use next_offset to page)default: 0
querystringOptional text to find in the whole document; returns matches with offsets instead of a text window
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageReadme
HKEx Filing Scraper
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.
Details
- Repository
- github.com/simonmak-ascent/hkex-filing-scraper
- Website
- hkex-listco-updates.ascent-partners.com
- Package
hkex-filing-scraper- Transport
- STDIO, HTTP
- Registry
- MCP registry, active
- Tools verified
- Nov 6, 2026