
bukely/hsbc-tradetrack-mcp
API developmentUnofficial MCP server for HSBC TradeTrack (汇丰交易追踪): trending stocks and top-5% traders' buy/sell/hold lists for US & HK, via HSBC's public no-login endpoints. No account or auth required.
Overview
Unofficial MCP server for (汇丰交易追踪 / 匯豐交易追蹤): the US and Hong Kong stocks HSBC personal banking investors trade most, and what HSBC's top 5% performing traders buy, sell and hold. All data comes from HSBC's (the same ones behind the pre-logon TradeTrack page). No HSBC account, API key or authentication is needed. 关键词:汇丰交易追踪、汇丰热门股票、前5%表现最好投资者、买入卖出比例、美股、港股、MCP。 early (0.x). The tool schema may still change between minor versions. Runs locally over stdio and needs uv. Requests go from your machine straight to HSBC. Agents that need a URL rather than a local command (claude.ai, cloud-hosted agents, other machines) can run their own instance over streamable HTTP. There is no public instance. The endpoint is http:// :8000/mcp. Any platform that runs a command works (a VPS, Railway, Render, Fly.io); put TLS in front of it. The server has no auth of its own, so add your platform's access control if you don't want the URL to be open.
README
hsbc-tradetrack-mcp
Unofficial MCP server for HSBC TradeTrack (汇丰交易追踪 / 匯豐交易追蹤): the US and Hong Kong stocks HSBC personal banking investors trade most, and what HSBC’s top 5% performing traders buy, sell and hold.
All data comes from HSBC’s public, no-login endpoints (the same ones behind the pre-logon TradeTrack page). No HSBC account, API key or authentication is needed.
关键词:汇丰交易追踪、汇丰热门股票、前5%表现最好投资者、买入卖出比例、美股、港股、MCP。
Status: early (0.x). The tool schema may still change between minor versions.
Quick start
Runs locally over stdio and needs uv. Requests go from your machine straight to HSBC.
claude mcp add hsbc-tradetrack -- uvx hsbc-tradetrack-mcp
{
"mcpServers": {
"hsbc-tradetrack": { "command": "uvx", "args": ["hsbc-tradetrack-mcp"] }
}
}
Self-host for remote and cloud agents
Agents that need a URL rather than a local command (claude.ai, cloud-hosted agents, other machines) can run their own instance over streamable HTTP. There is no public instance.
FASTMCP_TRANSPORT=http FASTMCP_HOST=0.0.0.0 FASTMCP_PORT=8000 uvx hsbc-tradetrack-mcp
The endpoint is http://:8000/mcp. Any platform that runs a command works (a VPS, Railway, Render, Fly.io); put TLS in front of it. The server has no auth of its own, so add your platform’s access control if you don’t want the URL to be open.
On FastMCP Cloud, fork this repo and deploy it with the entrypoint src/hsbc_tradetrack_mcp/server.py:mcp; the free plan keeps the server private to your account.
Tools
| Tool | Arguments | Returns |
|---|---|---|
tradetrack |
market (US/HK), lists (default: all four), period (today, yesterday, last_month; last_3_months/last_6_months for top_hold) |
Latest lists |
tradetrack_history |
market, date_from, date_to (≤ 31 days), lists, symbol |
Every intraday snapshot collected since 2026-10-16 |
Example prompt: “Which US stocks are HSBC’s top 5% traders buying today that they weren’t buying yesterday?”
Use with Interactive Brokers
skills/tradetrack-follow is an example agent workflow that follows the top 5% traders through IBKR’s official MCP connector: entries when they buy a stock two days in a row, exits when they sell out or a stop is hit. It drafts IBKR order instructions; nothing trades until you submit them in IBKR. The strategy is untested: use a paper account.
claude mcp add --transport http ibkr https://api.ibkr.com/v1/api/mcp-public
curl -fsSL --create-dirs -o ~/.claude/skills/tradetrack-follow/SKILL.md \
https://raw.githubusercontent.com/BukeLy/hsbc-tradetrack-mcp/main/skills/tradetrack-follow/SKILL.md
Then run /tradetrack-follow in Claude Code, optionally with overrides such as “US only, stop loss 5%”.
To run it as a scheduled task, schedule it on weekdays after the last refresh, naming the time zone (16:30 America/New_York for US), with a prompt such as “unattended, live account, US only”: it then drafts instructions without asking, skips a market that did not trade that day, and skips stocks that already have a draft or working order. In ChatGPT, add this server (see Self-host) and the Interactive Brokers plugin, then give SKILL.md to Plugin Creator to bundle the three.
Lists
| List | What it shows | US refresh (ET) | HK refresh (HKT) |
|---|---|---|---|
| Hot (all investors) | Top 10 most actively traded stocks, buy % vs sell % | 09:35, then every 30 min 10:00–16:00 | 09:35, then every 30 min 10:00–16:30 |
| Top buy (top 5%) | Top 10 stocks bought; split into new vs added positions | 11:30, 13:00, 16:00 | 12:30, 15:30, 16:10 |
| Top sell (top 5%) | Top 10 stocks sold; split into partial vs full exits | same | same |
| Top hold (top 5%) | Top 10 holdings with 1d / 1m / 3m / 6m ranks | same | same |
“Top 5%” means active HSBC stock traders whose portfolios returned the top 5% over the past 6 months.
Historical data
HSBC only serves today, yesterday and last month. A scheduled workflow appends every new snapshot to the data branch, one file per market per trading day:
https://raw.githubusercontent.com/BukeLy/hsbc-tradetrack-mcp/data//.jsonl
Each line is {"list", "dateType", "fetched_at", "raw"}, where raw is HSBC’s unmodified response.
Disclaimer
Not affiliated with, endorsed by, or connected to HSBC. “HSBC” and “TradeTrack” are trademarks of their owner. The data belongs to HSBC and may be delayed, incomplete or wrong. Nothing here is investment advice.
License
Install
uvx hsbc-tradetrack-mcpConfiguration
{
"mcpServers": {
"hsbc-tradetrack": { "command": "uvx", "args": ["hsbc-tradetrack-mcp"] }
}
}