🇭🇰

HKEXnews Announcement MCP

v0.1.0

Data IngestionRecommendedLocal

Local MCP service running via uvx to access HKEXnews announcement data through structured tools, including list queries, PDF/HTML download & parsing, and full-text keyword search. v0.1 excludes full periodic report PDFs (annual/interim/quarterly/ESG); results announcements remain in scope. No API Key required.

📖 Docs 🔗 Source

§ Quickstart

Add the following to your MCP client configuration (Cursor, Claude Desktop, etc.):

Settings (top right) → Cursor Settings → Features → MCP → Add New MCP Server. Set to command, type uvx.

MCP Client Configuration

{
  "mcpServers": {
    "mcp-hkexnews": {
      "command": "uvx",
      "args": [
        "agentladle-mcp-hkexnews"
      ]
    }
  }
}

Config file locations

Please ensure Python uv tool is installed.

§ Tools Reference

6 tools

list_hkexnews_announcements

Discover available HKEXnews announcements (full periodic report PDFs excluded)

Parameter	Type	Required	Description
stock_code	string	✓	5-digit HK stock code, e.g. "00700"
category	string	—	t1/t2 code or category name, e.g. "Inside Information"
start_date	string	—	Start date YYYY-MM-DD
end_date	string	—	End date YYYY-MM-DD
title_keyword	string	—	Title keyword
limit	number	—	Max results, default 10

Returns:Array

download_hkexnews_announcement

Download announcement PDF (HTML fallback); idempotent

Parameter	Type	Required	Description
stock_code	string	✓	5-digit HK stock code
release_date	string	—	Release date YYYY-MM-DD
title_keyword	string	—	Title substring
category	string	—	Category filter
news_id	string	—	HKEXnews NEWS_ID
local_key	string	—	Bundle key from list results

Returns:Object

parse_hkexnews_announcement

Parse downloaded PDF/HTML into page-by-page JSON

Parameter	Type	Required	Description
local_key	string	✓	Bundle key, e.g. "00700_13500_2026-03-15_a1b2c3d4"

Returns:Object

keyword_search

Full-text keyword search with TF relevance scoring

Parameter	Type	Required	Description
local_key	string	✓	Bundle key
keywords	string[]	✓	1–5 keywords
match_mode	string	—	"ANY" (default) or "ALL"
max_results	number	—	Max results, default 5

Returns:Array

get_announcement_pages

Read announcement content by page range

Parameter	Type	Required	Description
local_key	string	✓	Bundle key
start_page	number	✓	Start page (1-based)
page_count	number	—	Page count, default 3

Returns:Array

lookup_stock_code

Diagnostic: look up stock code → stockId mapping

Parameter	Type	Required	Description
stock_code	string	✓	5-digit HK stock code
refresh	boolean	—	Force refresh mapping

Returns:Object

§ Examples

Once configured, you can ask the AI directly:

Fast Full-text Search (Cached)

Search for buyback content in Tencent's latest announcement.

When cache exists, call keyword_search directly with keywords like "buyback" to extract highlighted snippets.

Download and Analyze from Scratch

What does Tencent's latest announcement say?

Call list_hkexnews_announcements → download → parse → keyword_search (EAFP: search first, download/parse on miss).

List Latest Announcements

List Tencent's recent announcements.

Call list_hkexnews_announcements with stock_code="00700" and an appropriate limit.