protogrid

Search / com.ascent-partners/hkex-filings

HKEx Filings

R0· no sign-in

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

v2.4.3 · active · repository · website · descriptor JSON · versions

An agent can connect right now, no human step.Remote endpoint, no authentication, reachable on the last probe.
Quality89new
Trust96of 100
Uptime, 30 days100%
Latency p501663 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "hkex-filings": {
      "type": "http",
      "url": "https://hkex-listco-updates.ascent-partners.com/api/mcp"
    }
  }
}
claude mcp add --transport http hkex-filings https://hkex-listco-updates.ascent-partners.com/api/mcp
[mcp_servers.hkex-filings]
url = "https://hkex-listco-updates.ascent-partners.com/api/mcp"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "hkex-filings": {
      "type": "remote",
      "url": "https://hkex-listco-updates.ascent-partners.com/api/mcp",
      "enabled": true
    }
  }
}
{
  "mcpServers": {
    "hkex-filings": {
      "type": "http",
      "url": "https://hkex-listco-updates.ascent-partners.com/api/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=hkex-filings&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vaGtleC1saXN0Y28tdXBkYXRlcy5hc2NlbnQtcGFydG5lcnMuY29tL2FwaS9tY3AifQ%3D%3D"
}
{
  "servers": {
    "hkex-filings": {
      "type": "http",
      "url": "https://hkex-listco-updates.ascent-partners.com/api/mcp"
    }
  }
}
{
  "mcpServers": {
    "hkex-filings": {
      "httpUrl": "https://hkex-listco-updates.ascent-partners.com/api/mcp"
    }
  }
}
extensions:
  "hkex-filings":
    enabled: true
    name: "hkex-filings"
    type: streamable_http
    uri: "https://hkex-listco-updates.ascent-partners.com/api/mcp"
    timeout: 300

Quality 89 / 100new

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene100 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations4 of 4 tools declare readOnlyHint or destructiveHint
  • pass
    tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
  • pass
    tools.token_costabout 1,205 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stabilityn/a · weight 15
  • n/a
    stability.changes, stability.rug_pulltool history recorded for 6 of the 7 days needed
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvabledeps.dev does not know [email protected]

4 tools, about 1,205 tokens to load them all · tool set 8e39279b4eec · checked 2026-10-21 00:32 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 96 / 100

provenance85
liveness100
freshness100
hygiene100

+repository +dns-namespace +website +reachable +uptime-100% +updated-6d-ago

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Dependencies

[email protected] PyPIthis version is not known to the dependency resolver

Dependency graphs from deps.dev; advisories from OSV.dev, including the GitHub Advisory Database and the PyPI Advisory Database; all CC BY 4.0. The graph is what a clean install of this version resolves today; nothing was installed or run. How it is checked.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://hkex-listco-updates.ascent-partners.com/api/mcp streamable-httpnoneyes100%1663 ms2025-11-252026-10-20
packageregistryversionruntimesecrets
hkex-filing-scraperpypi2.4.3uvx

Tools (4)

get_filingread-onlyDownload 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_inforead-onlyReport this live gateway's version, transport, and hard limits. Reads nothing.
list_filing_facetsread-onlyBrowse 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_filingsread-onlySearch 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.

Schemas: list_tools.

Similar MCP servers

More from com.ascent-partners

And 1 more from this publisher.

Official server.json
{
  "name": "com.ascent-partners/hkex-filings",
  "icons": [
    {
      "src": "https://raw.githubusercontent.com/simonmak-ascent/hkex-filing-scraper/main/docs/social_preview.png",
      "mimeType": "image/png"
    }
  ],
  "title": "HKEx Filings",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://hkex-listco-updates.ascent-partners.com/api/mcp",
      "type": "streamable-http"
    }
  ],
  "version": "2.4.3",
  "packages": [
    {
      "version": "2.4.3",
      "transport": {
        "type": "stdio"
      },
      "identifier": "hkex-filing-scraper",
      "runtimeHint": "uvx",
      "registryType": "pypi",
      "packageArguments": [
        {
          "type": "positional",
          "value": "hkex-scraper-mcp"
        }
      ],
      "runtimeArguments": [
        {
          "name": "--from",
          "type": "named",
          "value": "hkex-filing-scraper"
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/simonmak-ascent/hkex-filing-scraper",
    "source": "github"
  },
  "websiteUrl": "https://hkex-listco-updates.ascent-partners.com/",
  "description": "Live HKEx (Hong Kong Stock Exchange) regulatory filings for AI agents."
}