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

View on GitHub

Install

From registry metadata

$ npx add-mcp https://hkex-listco-updates.ascent-partners.com/api/mcp --name hkex-filings

Run 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/mcp

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 4 tools

Verified 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

categorystring

Optional case-insensitive substring of the headline category

document_typestring

Optional exact file type, e.g. PDF, HTML, XLS, DOC

from_date*string

YYYY-MM-DD or DD/MM/YYYY

max_resultsinteger

Maximum filings to fetch and return (default 50, cap 200)

stock_codestring

Optional exact HKEx stock code, e.g. 01461

stock_namestring

Optional case-insensitive substring of the stock short name

title_querystring

Optional case-insensitive substring of the filing title

to_date*string

YYYY-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*string

YYYY-MM-DD or DD/MM/YYYY

max_resultsinteger

Maximum filings to scan (default 50, cap 200)

stock_codestring

Optional exact HKEx stock code to narrow the facets

to_date*string

YYYY-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

extractboolean

Extract text and tables; false returns size and content type onlydefault: true

link*string

HKEx document URL from a search_filings result (host www1.hkexnews.hk)

max_charsinteger

Maximum characters of document_text to return in this windowdefault: 300000

offsetinteger

Character offset where the returned text window starts (use next_offset to page)default: 0

querystring

Optional text to find in the whole document; returns matches with offsets instead of a text window

Readme

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.

HKEx Filing Scraper — one scraper, many databases

View the full README on GitHub

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