HKEx Filings — Claude Code MCP server: regulatory filings access
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.
claude mcp add --transport http hkex-filings https://hkex-listco-updates.ascent-partners.com/api/mcpWhat HKEx Filings 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.
What it helps with
- 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 for the agent
- Connect the hosted
hkex-filingsgateway and search all filings from September 2026 for stock code 0700 - Use
hkex-filingsto fetch Tencent's interim report and summarize key metrics - Scrape the latest 100 HKEx filings into SQLite with
hkex-scraper --metadata-only --limit 100
How to install HKEx Filings
1Platform CLI: remote server
claude mcp add --transport http hkex-filings https://hkex-listco-updates.ascent-partners.com/api/mcp2Platform CLI
claude mcp add hkex-filings -- uvx hkex-filing-scraperuvx runs the command named after the package; if the README names another one, use uvx --from hkex-filing-scraper <command>
1Platform CLI: remote server
codex mcp add hkex-filings --url https://hkex-listco-updates.ascent-partners.com/api/mcp2Platform CLI
codex mcp add hkex-filings -- uvx hkex-filing-scraperuvx runs the command named after the package; if the README names another one, use uvx --from hkex-filing-scraper <command>
Config file
{
"mcpServers": {
"hkex-filings": {
"url": "https://hkex-listco-updates.ascent-partners.com/api/mcp"
}
}
}{
"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>
Config file
{
"servers": {
"hkex-filings": {
"type": "http",
"url": "https://hkex-listco-updates.ascent-partners.com/api/mcp"
}
}
}{
"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>
1Platform CLI: remote server
gemini mcp add -t http hkex-filings https://hkex-listco-updates.ascent-partners.com/api/mcp2Platform CLI
gemini mcp add hkex-filings uvx hkex-filing-scraperuvx runs the command named after the package; if the README names another one, use uvx --from hkex-filing-scraper <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about HKEx Filings
How to install HKEx Filings in Claude Code?
For the hosted gateway with no install: claude mcp add --transport http hkex-filings https://hkex-listco-updates.ascent-partners.com/api/mcp. For the local stdio server: claude mcp add hkex-filings -- uvx hkex-filing-scraper.
What does HKEx Filings do?
It gives an AI agent access to Hong Kong Stock Exchange regulatory filings: search by date range and filters, download PDFs with text and table extraction. The public gateway needs no key; the local version scrapes filings into nine database types.
Do I need an API key for HKEx Filings?
No. The public gateway at https://hkex-listco-updates.ascent-partners.com/api/mcp works without a key or signup. The local server also needs no key: it calls the undocumented HKEx JSON API directly.
