
Hk Stocks
Keyless MCP server for Hong Kong index levels, HKEX stock quotes and name-to-ticker lookup
- Pricing
- Freemium
- Platforms
- API, CLI, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.2.1
- Listing updated
- today
Similar MCP servers
About Hk Stocks
Hk Stocks is a freemium MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.
The server gives AI assistants live access to the Hang Seng index family, covering HSI, HSCEI H-shares, HSTECH, HSCCI red chips and the VHSI volatility gauge. Each snapshot reports closing level, change, day and 52-week ranges, and the README notes that index turnover and volume are intentionally left out because the upstream fields could not be reconciled.
For individual companies, a quote tool returns English and Chinese names, price, change, day range, share volume, HKD turnover and P/E for codes written in several formats. A resolver turns a company name in English or Chinese into an HKEX code, and the README explains that it filters out warrants and RMB counters so the result is the actual share.
The README says it is an unofficial bridge to the Pipeworx gateway and is aimed at developers and agent builders who want Hong Kong market data without registering for an API key. Anonymous use is capped daily, and a free Pipeworx account raises the limit.
Install
Run in a terminal
claude mcp add --transport http hk-stocks https://gateway.pipeworx.io/hk-stocks/mcpAdd to Settings → Connectors → Add custom connector
https://gateway.pipeworx.io/hk-stocks/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"hk-stocks": {
"url": "https://gateway.pipeworx.io/hk-stocks/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"hk-stocks": {
"type": "http",
"url": "https://gateway.pipeworx.io/hk-stocks/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"hk-stocks": {
"serverUrl": "https://gateway.pipeworx.io/hk-stocks/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"hk-stocks": {
"type": "http",
"url": "https://gateway.pipeworx.io/hk-stocks/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PIPEWORX_API_KEYOptional Pipeworx API key. Without it calls are anonymous and capped daily; a free key raises the cap.
Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- hk_market_snapshot
- Closing level, change, day and 52-week range for the Hang Seng index family and VHSI.
- hk_quote
- Real-time quotes for Hong Kong-listed stocks by HKEX code.
- hk_resolve_symbol
- Finds the HKEX stock code for a company by name.
What it does
- Hang Seng index snapshot
- Returns closing level, change, day range and 52-week range across the HSI family and VHSI.
- Hong Kong stock quotes
- Provides real-time quotes for HKEX codes, accepting several code formats in one request.
- Name to ticker lookup
- Resolves English or Chinese company names to the HKEX code of the listed share.
- Keyless access
- Works without an API key on the hosted endpoint, with an optional key for a higher daily cap.
- Multiple connection options
- Can be used through a remote streamable HTTP endpoint or a local npm stdio package.
Good for
- Checking how the Hang Seng index closed on a given day
- Looking up the current price and P/E of a Hong Kong listed company
- Finding the correct HKEX code for a company before requesting its quote
- Adding Hong Kong market data to an AI assistant or agent workflow
Pricing
Freemium, from $49 a month
Anonymous use capped at 50 calls a day; free account 200 a day; paid plans from $49/month
Prices change. Check pipeworx.io before you buy.
Hk Stocks FAQ
Does it need an API key?
The README says it is keyless. Anonymous calls are capped at 50 a day, and a free Pipeworx account raises the cap to 200 a day.
Why does the snapshot omit index turnover?
The README says the upstream index turnover and volume fields could not be reconciled with known HKEX figures, so they are left out rather than relabelled.
Can it resolve Chinese company names?
Yes. The README says the resolver handles both English and Chinese input, using different upstream sources for each.
Is Hk Stocks free?
Hk Stocks has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.
How do I add Hk Stocks to Claude Code?
Run this command in your terminal: claude mcp add --transport http hk-stocks https://gateway.pipeworx.io/hk-stocks/mcp
What are the best alternatives to Hk Stocks?
The closest alternatives to Hk Stocks are HKEx Filings, MCP Stock Analyst, Taiwan Stocks, A股数据 API (A-Share Data API) and Wudao A-Share Stock Data MCP.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.
