MCP.Market

HKEx Filings MCP server

online · 96% uptime
by ascent-partners.com·com.ascent-partners/hkex-filings·v2.4.3·16 stars

Live HKEx (Hong Kong Stock Exchange) regulatory filings for AI agents.

A90/100grade A
What users say
No reviews yet
Be the first
Safety scan
A90/100

full report

Adoption
Established

16 stars110 downloads/wk

Reviews

Write one

Nobody 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 posts
  • get_filingFree

    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.

  • get_server_infoFree

    Report this live gateway's version, transport, and hard limits. Reads nothing.

  • list_filing_facetsFree

    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.

  • search_filingsFree

    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.

Public scan report

scanner v0.1.10 · 2026-10-14 · same rubric, same numbers if you re-run it

no findings
  • 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
Overall 90/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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 MCP
    55 tools for Indian stock markets — NSE & BSE quotes, screener, filings, FII/DII, options
    A
  • Torus
    Stock research memory for Claude: theses, sourced claims and SEC filing alerts in a local graph
    A
  • Yahoo Finance
    Access Yahoo Finance stock data, news, screeners, options, financials, and charts through MCP.
    A
  • Akshare One
    MCP server that provides access to Chinese stock market data using akshare-one
    A
  • Kronos
    Stock price forecasting for China A-shares — Kronos K-line time-series model
    B

More from ascent-partners.com →