# HKEx Filings

MCP server that gives AI agents access to 25+ years of Hong Kong Stock Exchange regulatory filings. Works via a public gateway or locally with nine database targets.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 16
- Author: simonmak-ascent
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/simonmak-ascent/hkex-filing-scraper
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/hkex-filings

## What it does

The server speaks to the undocumented HKEx JSON API and returns filing metadata, full text, and tables extracted from PDFs. The public gateway at `https://hkex-listco-updates.ascent-partners.com/api/mcp` requires no setup or API key: four tools — search within a 31-day window with filters for stock code, document type, and category; list facets for a window; fetch a single filing with text and table extraction; and server info. The local variant (`pip install hkex-filing-scraper`) scrapes filings into PostgreSQL, MySQL, SQLite, MongoDB, Neo4j, ClickHouse, DuckDB, MariaDB, or SurrealDB and runs a stdio server with a wider tool catalog.

MIT license, Python 3.10+. The stdio server needs `uvx` and the installed package; the gateway needs only a URL in the agent config. Listed in the official MCP Registry as `com.ascent-partners/hkex-filings` and published on Glama with a 4.7/5 tool-quality score.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Remote server: `https://hkex-listco-updates.ascent-partners.com/api/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http hkex-filings https://hkex-listco-updates.ascent-partners.com/api/mcp
```

2. **Platform CLI**
```bash
claude mcp add hkex-filings -- uvx hkex-filing-scraper
```
uvx runs the command named after the package; if the README names another one, use uvx --from hkex-filing-scraper <command>

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add hkex-filings --url https://hkex-listco-updates.ascent-partners.com/api/mcp
```

2. **Platform CLI**
```bash
codex mcp add hkex-filings -- uvx hkex-filing-scraper
```
uvx runs the command named after the package; if the README names another one, use uvx --from hkex-filing-scraper <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hkex-filings": {
            "url": "https://hkex-listco-updates.ascent-partners.com/api/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "hkex-filings": {
            "command": "uvx",
            "args": [
                "hkex-filing-scraper"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from hkex-filing-scraper <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hkex-filings": {
            "type": "http",
            "url": "https://hkex-listco-updates.ascent-partners.com/api/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "hkex-filings": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "hkex-filing-scraper"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from hkex-filing-scraper <command>

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http hkex-filings https://hkex-listco-updates.ascent-partners.com/api/mcp
```

2. **Platform CLI**
```bash
gemini mcp add hkex-filings uvx hkex-filing-scraper
```
uvx runs the command named after the package; if the README names another one, use uvx --from hkex-filing-scraper <command>

## When to use it
- fetch regulatory filings from Hong Kong Stock Exchange for any date range
- extract text and tables from HKEx PDF reports for analysis
- query HKEx filings from an AI agent without manual scraping
- build a full-text corpus of HKEx filings in your own database

## Example prompts
- Connect the hosted `hkex-filings` gateway and search all filings from September 2026 for stock code 0700
- Use `hkex-filings` to fetch Tencent's interim report and summarize key metrics
- Scrape the latest 100 HKEx filings into SQLite with `hkex-scraper --metadata-only --limit 100`

## Similar
- [World Monitor](https://affpapa.org/en/nevibecode/mcp/world-monitor.md) — MCP server · ★ 89408
- [Scrapling MCP Server](https://affpapa.org/en/nevibecode/mcp/scrapling-mcp-server.md) — MCP server · ★ 89433
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [dbx](https://affpapa.org/en/nevibecode/mcp/dbx.md) — MCP server · ★ 27669
- [Metabase](https://affpapa.org/en/nevibecode/mcp/metabase.md) — MCP server · ★ 49845

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md