Hk Stocks MCP server

@pipeworx/hk-stocks

Live Hong Kong equity market data — the full Hang Seng index family and real-time HKEX stock quotes, with a name→code resolver that returns the actual share rather than its warrants.

Part of Pipeworx — an MCP gateway connecting AI agents to 1576+ live data sources.

Tools

52-week range for HSI (恒生指数), HSCEI (恒生中国企业指数, H-shares), HSTECH (恒生科技指数), HSCCI (恒生香港中资企业指数, red chips), and VHSI (恒指波幅指数, volatility). Answers "how did Hong Kong close".

• hkmarketsnapshot() — closing level, change, change %, day range and

price, change, open/prev close, day high/low, share volume, HKD turnover, P/E, 52-week range. Accepts 700, 00700, 0700.HK, HK:700.

• hk_quote({ codes }) — real-time quotes by HKEX code. English + Chinese name,

Chinese input.

• hkresolvesymbol({ name }) — company name → HKEX code. Handles English and

Auth

Keyless. Both upstreams are public and unauthenticated; no registration, no quota to negotiate.

Data sources

quotes. GBK-encoded, not UTF-8 — decode from raw bytes (new TextDecoder('gbk')), or every Chinese name arrives as mojibake.

• — index levels and equity

input.

• — name→code for Chinese

Latin input.

• — name→code for

Things worth not rediscovering

Neither resolver upstream covers both scripts, which is why there are two.

result set. It cannot answer Chinese queries at all.

• Yahoo rejects non-ASCII outright — q=小米 returns HTTP 400, not an empty

TENCENT N4104, TENCENT N6006, TENCENT N3606-R … and never 00700. On Chinese input (key=腾讯) the same endpoint ranks the real equity first. So Sina is used for CJK, Yahoo for Latin, and Yahoo-miss falls back to Sina.

• Sina's HK suggest is a warrant index on Latin input. key=tencent returns

HKEX code ranges do the filtering. Equities and GEM sit below 10000; 10000–69999 are derivative warrants and CBBCs; 80000+ are the RMB counters of dual-counter stocks (80700 is Tencent's RMB line, not its HKD share). Both are plausible-looking wrong answers to "Tencent's HK code", so a single < 10000 threshold excludes both.

Index turnover/volume are deliberately not returned. Sina populates fields 11/12 as HKD turnover and share volume for equities — verifiable, since 36,203,193 shares × ~HK$462 reconciles to the HK$16.76bn turnover it reports. On index rows those slots hold something else: HSI reports 312,233,275 and 14,192,915,767, neither of which reconciles against known HKEX daily market turnover. Rather than relabel a number we cannot account for, the snapshot omits it and says so. Per-stock turnover from hk_quote is sound.

A missing listing returns an empty payload, not an error. Sina answers an unknown code with var hqstrrt_hk99999=""; — HTTP 200. Callers must treat an empty field list as not-found, or a nonexistent stock silently becomes a quote with null prices.

Quick Start

Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "hk-stocks": {
      "url": "https://gateway.pipeworx.io/hk-stocks/mcp"
    }
  }
}

What this endpoint actually serves

tools/list at https://gateway.pipeworx.io/hk-stocks/mcp returns the tools in the table above plus the shared Pipeworx meta-tools — askpipeworx, discovertools, search_within, remember/recall and the rest of the gateway-wide set. So the tool count you see is larger than this table: a single-pack endpoint currently lists roughly 30 shared tools alongside the pack's own. The connection's initialize response states its exact scope, and is the authoritative answer for a given day.

Shortened. The full README is on GitHub.