# HKEx Filings

> HKEx Filings is an open-source MCP server for finance and payments. Hong Kong Stock Exchange filings for AI agents: live search or a full-text local archive. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, self-hosted
- **Website:** https://hkex-listco-updates.ascent-partners.com
- **Repository:** https://github.com/simonmak-ascent/hkex-filing-scraper
- **MCP Registry name:** com.ascent-partners/hkex-filings
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-15

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://hkex-listco-updates.ascent-partners.com/api/mcp
```

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/hkex-filings
