Skip to main content

TradeTrack MCP

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"] }
  }
}

Before the first PyPI release, use uvx --from git+https://github.com/BukeLy/hsbc-tradetrack-mcp hsbc-tradetrack-mcp instead.

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?"

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/<US|HK>/<YYYY-MM-DD>.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

MIT

Metadata

Release files for hsbc-tradetrack-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for hsbc-tradetrack-mcp 0.1.0
File Size Uploaded
hsbc_tradetrack_mcp-0.1.0.tar.gz 8.1 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for hsbc-tradetrack-mcp 0.1.0
File Interpreter ABI Platform
hsbc_tradetrack_mcp-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 17.2 kB

Release files / hsbc_tradetrack_mcp-0.1.0.tar.gz

Download URL hsbc_tradetrack_mcp-0.1.0.tar.gz
Size 8.1 kB
Tags Source
SHA-256 checksum
How to use checksums
706c387e16e89f2ad09967987c154066d11868cd4b20b1c6af48ca0102d2557e
BLAKE2b-256 checksum
How to use checksums
1ce28c5ffc8e74341003e3f6bc4cdee9272daaeec71bbeecdf6f905039aa4130
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.

Transparency log

Release files / hsbc_tradetrack_mcp-0.1.0-py3-none-any.whl

Download URL hsbc_tradetrack_mcp-0.1.0-py3-none-any.whl
Size 9.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
7ee241e55f74d77162f14bedcafdc2bb45b37bf5ac223c622f3b8067aa547559
BLAKE2b-256 checksum
How to use checksums
671d9c7ec4590fec32230bdf4b653dcd70e99f03082e5c751c084b92176855d4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 16, 2026.

Transparency log

Release history Release notifications | RSS feed

0.1.1

2 release files

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page