Skip to content
MCP server

HKEx Filings

Hong Kong Stock Exchange filings for AI agents: live search or a full-text local archive

Install
Pricing
Open source
Platforms
API, CLI, self-hosted
Runs
Locally or Remotely
Version
2.4.3
Listing updated
2 days ago

About HKEx Filings

HKEx Filings is an open-source MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.

HKEx Filings comes in two forms. The hosted gateway is public and keyless, queries HKEx live and stores nothing. It has four read-only tools: get_server_info, search_filings (a window of up to 31 days, filtered by stock code, title, document type, category or stock name), list_filing_facets, and get_filing, which downloads a document and extracts its text and tables. The second form is the open-source hkex-scraper Python CLI, which the README says builds a bulk, full-text corpus of 25-plus years of filings from April 1999, because HKEXnews search returns one page at a time.

The scraper talks to the undocumented HKEx JSON API rather than driving a browser, extracts text and tables from PDF, HTML and Excel, and writes to any combination of PostgreSQL, MySQL or MariaDB, SQLite, MongoDB, Neo4j, ClickHouse, DuckDB and SurrealDB. A local stdio MCP server exposes a wider tool catalogue over the stored data.

It is MIT licensed and published on PyPI, with client setup for Claude, ChatGPT, Cursor, VS Code, Gemini CLI, opencode, Manus and Perplexity.

Install

Run in a terminal

claude mcp add --transport http hkex-filings https://hkex-listco-updates.ascent-partners.com/api/mcp

Add to Settings → Connectors → Add custom connector

https://hkex-listco-updates.ascent-partners.com/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hkex-filings": {
      "url": "https://hkex-listco-updates.ascent-partners.com/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "hkex-filings": {
      "type": "http",
      "url": "https://hkex-listco-updates.ascent-partners.com/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "hkex-filings": {
      "serverUrl": "https://hkex-listco-updates.ascent-partners.com/api/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "hkex-filings": {
      "type": "http",
      "url": "https://hkex-listco-updates.ascent-partners.com/api/mcp"
    }
  }
}

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

get_server_info
Returns server information
search_filings
Searches filings in a window of up to 31 days with filters
list_filing_facets
Lists what a window contains
get_filing
Downloads one document and extracts its text and tables

What it does

Live gateway
Query HKEx filings with no key and no storage.
Document extraction
get_filing pulls text and tables from a single filing.
Facet browsing
See what a date window contains before searching.
Full-history scraper
Backfill filings since April 1999 into your own databases.
Nine database targets
Write to several engines at once with idempotent upserts.
Local MCP catalogue
A stdio server offers more tools over the stored corpus.

Good for

  • Summarise an interim report published in a given window
  • Find filings for a stock code and document type
  • Build a searchable archive of HKEx disclosures
  • Feed filings into a graph or analytics database

Pricing

Open source

MIT licensed; free hosted gateway

Prices change. Check hkex-listco-updates.ascent-partners.com before you buy.

HKEx Filings FAQ

Do I need an API key?

No, the hosted gateway is keyless.

How wide can a search window be?

Up to 31 days.

Is the data stored?

Not by the hosted gateway; the local pipeline stores it in your databases.

What licence?

MIT.

Is HKEx Filings free?

Yes. HKEx Filings is open source, so you can use and self-host it for free.

How do I add HKEx Filings to Claude Code?

Run this command in your terminal: claude mcp add --transport http hkex-filings https://hkex-listco-updates.ascent-partners.com/api/mcp

What are the best alternatives to HKEx Filings?

The closest alternatives to HKEx Filings are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to HKEx Filings

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments