@pipeworx/mcp-china-stocks
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Contacts while installing and starting: gateway.pipeworx.io
What it contacted
gateway.pipeworx.io
Hosts it looked up or connected to while installing and starting with no input, watched from outside its sandbox. The npm registry is left out. Says nothing about what its tools contact when called.
Starting it
npx -y @pipeworx/mcp-china-stocks@0.2.1
Installing a package runs its code. Use a sandbox for anything you have not read.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
2 tools with commands in capitals or very long text
- Gives the agent orders in
ashares_etf_shares:'how many shares outstanding does this ETF have over time'. IMPORTANT: this is NOT a daily series — Chinese ETFs publicly disclose 份额 only at quarter-end plus occasional
- Gives the agent orders in
ashares_stock_connect:southbound trade today", "stock connect top traded stocks". IMPORTANT: mainland regulators (CSRC) stopped publishing DAILY net fund-flow figures (net buy/sell, daily inf
Common and usually harmless: it is how many makers stress how a tool should be used.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
ashares_limit_up date, limit
The Chinese A-share market's LIMIT-UP board (涨停板) for a trading day — how many stocks hit their daily price limit (+10%, or +20% for STAR/ChiNext) and the ranked list of those stocks. Answers 'how many A-shares hit limit up today', 'top limit-up stocks', 'which stocks 涨停'. Each stock includes code, name, price, change %, turnover (成交额), float market cap, turnover rate (换手率), consecutive-board count (连板数 lbc), first/last seal time, seal fund (封板资金), and industry (行业). Source: Eastmoney (keyless).
ashares_limit_down date, limit
The Chinese A-share market's LIMIT-DOWN board (跌停板) for a trading day — how many stocks hit their daily DOWN price limit (-10%, or -20% for STAR/ChiNext) and the ranked list of those stocks. Answers 'how many A-shares hit limit down today', '跌停家数', 'which stocks 跌停', 'limit-down stock count for a China A-share trading day' — the counterpart to ashares_limit_up, together giving market-wide limit-up/limit-down breadth. Each stock includes code, name, price, change % (negative), turnover (成交额), float market cap, turnover rate (换手率), seal fund (封板资金), last seal time, industry (行业), and P/E. Source: Eastmoney (keyless).
ashares_margin_financing symbol, date
China A-share margin financing and securities lending balance (融资融券余额/两融余额) — the market-wide leverage gauge: aggregate financing balance (融资余额, money borrowed to buy stock), securities-lending balance (融券余额, shares borrowed to short), and their combined total (融资融券余额), for the Shanghai (SSE) and Shenzhen (SZSE) exchanges separately and combined, with day-over-day change. Answers '融资余额', '两融余额', '融资融券余额', 'margin financing balance', 'China A-share margin debt', 'how much margin debt is in the A-share market', 'margin balance day over day change'. Pass a 6-digit SZSE code (0/3/159-prefixed) in `symbol` for that stock's own 融资余额/融券余额/融资融券余额 instead of the market aggregate — SSE (6xxxxx) per-stock detail is not available via any verified keyless route, so a SH code returns a clear not_available message rather than silently substituting. Margin data publishes T+1 (today's figures appear tomorrow morning); a request for a day with nothing published yet or a non-trading day (weekend/holiday) automatically falls back to the last trading day that published, and says so. Amounts in CNY (converted from each exchange's native 元/亿元/万元 units and labelled). Source: SSE query.sse.com.cn (keyless) + SZSE www.szse.cn ShowReport CATALOGID=1837_xxpl (keyless).
ashares_market_snapshot
Overall snapshot of the Chinese A-share market — the headline index levels (Shanghai Composite, Shenzhen Component, ChiNext, STAR 50, CSI 300) with change %, day range and turnover, plus market-wide breadth as a sentiment gauge: how many stocks hit limit-up (涨停) and limit-down (跌停) today. Answers 'how is the China A-share market doing', 'Shanghai Composite today', 'A-share market snapshot at close', 'how did Chinese stocks close', '涨跌停家数', 'limit-up limit-down counts today'. For the ranked pools use ashares_limit_up / ashares_limit_down; for market-wide margin financing leverage use ashares_margin_financing. Source: Sina + Eastmoney (keyless).
ashares_quote symbols
Real-time quote(s) for Chinese A-share stocks by 6-digit code (Shanghai 6xxxxx, Shenzhen 0xxxxx/3xxxxx, STAR 688xxx, ChiNext 30xxxx, Beijing 8xxxxx/4xxxxx). Returns name, current price, change and change %, open, previous close, day high/low, volume, turnover, and the quote timestamp. Accepts one code or a comma-separated list. Example: ashares_quote({ symbols: "600519,000858" }) for Kweichow Moutai and Wuliangye. Source: Sina (keyless).17 more tools
ashares_turnover_ranking limit, sort, order, board, date
Market-wide ranking of Chinese A-share stocks by turnover / 成交额排名, 成交额前30名, 成交量排名, or 涨跌幅排名 — the whole board (not specific codes), sorted server-side and returned as a ranked list. Answers 'A股成交额前30名', 'top 30 A-shares by turnover today', 'A股成交量排名', 'A-share market-wide ranking by amount/volume/change %', 'which A-shares traded the most today'. Each row has code, name, price, change %, volume (shares), turnover in CNY (成交额), turnover rate %, and industry (行业/板块, when resolvable). Omit `date` (or pass today) for the LIVE board (Sina, real-time). Pass a PAST trading day in `date` for that day's ranking instead of today's — this uses a different, Eastmoney-sourced historical path and only supports `sort:'changepercent'` (涨跌幅排名): no keyless bulk source for a PAST day's turnover amount or volume ranking was found (Sina's live board is the only amount/volume source), so `date` + `sort:'amount'|'volume'` throws a clear error naming that gap rather than silently substituting today's board. A non-trading `date` (weekend/holiday) walks back to the prior trading day automatically.
ashares_capital_flow code, days
Per-stock daily main-capital net inflow history (主力净流入 / 超大单+大单净流入, often called '超大单净流入' in retail trackers) for a Chinese A-share stock or ETF — one row per trading day with net inflow broken down by order size: 超大单 (super-large/institutional), 大单 (large), 中单 (medium), 小单 (small), plus 主力净流入 (main = 超大单+大单combined) in both CNY amount and as a % of that day's turnover. Answers '主力净流入历史', '超大单净流入', '000768最近20个交易日的主力资金流向', 'main capital net inflow history for a China A-share stock', 'which days did big money flow into/out of a stock'. A positive net inflow means net buying pressure from that order-size bucket that day, negative means net selling. Source: Eastmoney push2his fflow/daykline (keyless).
ashares_billboard date, limit
The Chinese A-share market's daily 龙虎榜 (dragon-tiger list / billboard) for a trading day — stocks flagged for unusual price/turnover deviation, with the top seats' buy/sell/net amounts, plus (when present that day) institution-seat (机构专用) net-buy detail and that day's most-active brokerage branches (营业部) market-wide as a 'top brokerages' signal. Answers '龙虎榜', 'dragon tiger list for a date', 'which stocks were on the billboard on 2026-09-24', '机构净买入', 'institution seat net buys', 'top active brokerage seats'. Each listed stock has the reason it was flagged (EXPLANATION, e.g. daily move ≥7%), close price, change %, and billboard buy/sell/net amounts in CNY; stocks that also had institutional-seat activity that day carry institution_net_buy_cny/institution_buy_seats/institution_sell_seats. A non-trading `date` (weekend/holiday) walks back to the prior trading day automatically. Source: Eastmoney datacenter-web (keyless).
ashares_etf_shares code, from, to
Disclosed fund-share-count (基金份额) and net-asset history for a Chinese-listed ETF — period-end total shares outstanding (期末总份额), the period's subscriptions/redemptions (期间申购/赎回), and period-end net assets (期末净资产), in shares and CNY. Answers '基金份额变动', 'ETF shares outstanding history', '515050规模变动', 'how many shares outstanding does this ETF have over time'. IMPORTANT: this is NOT a daily series — Chinese ETFs publicly disclose 份额 only at quarter-end plus occasional ad-hoc material-change dates (confirmed live for 515050/561980/588170/588200), not every trading day; a `from`/`to` window with no disclosure inside it returns found:false naming the nearest disclosed dates rather than fabricating daily rows. For a daily PRICE series use ashares_daily_history; this tool is share-count/AUM only. Source: Eastmoney fund F10 archive (keyless).
ashares_earnings_forecast symbol, limit
Company-issued earnings guidance (业绩预告) for a Chinese A-share stock — the company's own forecast announcements with predicted profit range (lower/upper bounds in CNY), year-over-year change %, forecast type (略增/预增/扭亏 etc.), and the company's stated reason. Answers '业绩预测', '业绩预告', 'earnings forecast/guidance for a China A-share company like 华工科技 000988'. Most recent reports first. Source: Eastmoney datacenter (keyless).
ashares_analyst_consensus symbol
Analyst consensus estimates (盈利预测) for a Chinese A-share stock — per forecast year: consensus EPS, P/E at current price, net profit attributable to parent (归母净利润), and total operating revenue, in CNY. Answers "analyst estimates / 盈利预测 / forecast EPS for a China A-share like 000988". Source: Eastmoney datacenter (keyless).
ashares_daily_history codes, start, end, adjust
Daily OHLCV history (历史日线) for one or more Chinese A-share stocks over a date range — open, high, low, close, volume, and day-over-day change % per trading day. Answers '300418在2026-08-31到2026-09-03的收盘价和涨跌幅', 'daily closes for 600519 last week', 'history for 000858 and 300750 this month', '涨跌幅历史', '历史成交量'. Up to 20 comma-separated 6-digit codes. change_pct is computed from consecutive closes within the returned range (the first row has no prior close in range, so it is null); turnover amount (成交额) is not exposed by this daily-bar source, so amount_cny is reported as "not_available" rather than estimated — use ashares_quote or ashares_turnover_ranking for same-day turnover amount. Source: Tencent/gtimg fqkline (keyless).
ashares_intraday_bars symbols, date, up_to, interval
Intraday minute bars (分钟线/分时/分钟K线) for Chinese A-share stocks/ETFs on a given trading日/交易日, with cumulative volume and turnover (累计成交量/累计成交额) computed up to a requested time of day (截至<time>, e.g. 截至11:05) — answers '515050在2026-09-01这个交易日截至11:05的累计成交量和累计成交额', '600519某个交易日截至某时刻的累计成交量和成交额', 'cumulative volume for 600519 up to 11:05 on a past trading day', 'intraday minute bars for an A-share on a specific date'. ashares_quote is realtime-only (today, right now) and ashares_daily_history is end-of-day-only (no intraday granularity) — this tool is for a PAST trading日's intraday trajectory. Returns the interval bars for that day plus cumulative_volume_shares/cumulative_turnover_cny summed from the day's open through `up_to` (or the whole day if `up_to` is omitted). `symbols` takes a bare 6-digit code (e.g. "515050") or the sh/sz/bj-prefixed form, same as ashares_quote. Bounded lookback: the upstream caps total bars at ~1950 regardless of interval, so retention shrinks as the interval shrinks — roughly 8 trading days at 1-minute, 40 at 5-minute (the default), 110 at 15-minute, a year at 30-minute, two years at 60-minute — and it slides forward daily. A `date` older than a result's `earliest_bar_date_available` is out of range for that interval; try a coarser interval, or use ashares_daily_history for daily (not intraday) history further back. Source: Sina (keyless).
ashares_technical_indicators codes, start, end, adjust, indicators, ma_windows, boll_period, boll_mult, macd_fast, macd_slow, macd_signal, kdj_n, kdj_m1, kdj_m2
Technical indicators for Chinese A-share stocks and ETFs (均线/布林/MACD/KDJ) — MA (moving averages, any windows, default MA5/MA10/MA20/MA60), BOLL (Bollinger Bands, default 20-period ×2 std dev), MACD (DIF/DEA/柱, default 12/26/9), and KDJ (K/D/J, default 9/3/3), computed from this pack's own daily OHLCV history (same source and codes as ashares_daily_history — ETF codes like 515050/588170/561980 work the same as stock codes). Answers '515050通信ETF华夏最近20个交易日MA5/MA10/MA20/BOLL/MACD/KDJ', '603986兆易创新周线MACD是否死叉', 'MA20 and BOLL for an A-share ETF', '布林带', '均线', '金叉死叉'. Internally fetches extra lookback history before `start` so the indicators are warmed up (MA60/MACD need ~60+ trading days of prior data) — only the requested [start, end] range is returned. MACD histogram uses the common Chinese charting convention 柱=2×(DIF−DEA); KDJ smoothing is the standard 3/3 recursive form seeded at 50. Up to 5 comma-separated codes per call (indicator math is heavier than a plain OHLCV pull). Source: Tencent/gtimg fqkline (keyless), same as ashares_daily_history.
ashares_sector_capital_flow date, limit, sort, order
China A-share INDUSTRY-SECTOR net capital inflow ranking (行业资金流向排名/板块资金流) for a trading day -- ranks Eastmoney's ~128 industry boards (行业板块) by main-capital net inflow (主力净流入), with the breakdown by order size (超大单/大单/中单/小单 net inflow in CNY), the day's change %, and each sector's single stock with the largest net inflow. Answers '今日行业资金流向排名', 'which industry sectors had the biggest net capital inflow today', '板块资金流排名', 'sector fund flow ranking', 'semiconductor sector money flow today'. This is a DIFFERENT metric from china-exchange-data's ashares_sector_flows, which is SZSE's own official per-industry TURNOVER ranking -- this tool is Eastmoney's vendor-computed NET INFLOW (主力净流入) classification, the sector-level counterpart to this pack's own per-stock ashares_capital_flow. A non-trading date (weekend/holiday, or before today's session has published -- publication usually lags a day) walks back automatically to the nearest prior trading day with data. Source: Eastmoney datacenter (keyless).
ashares_stock_connect date
Stock Connect (沪深港通) daily channel statistics: GROSS TURNOVER for Northbound (mainland A-shares bought via Hong Kong -- 沪股通/深股通/combined) and Southbound (Hong Kong-listed stocks bought by mainland investors -- 港股通沪/港股通深/combined), plus a best-effort per-stock "top traded stocks" list for Northbound. Answers "northbound stock connect turnover today", "沪深股通成交额", "how much did northbound/southbound trade today", "stock connect top traded stocks". IMPORTANT: mainland regulators (CSRC) stopped publishing DAILY net fund-flow figures (net buy/sell, daily inflow, remaining quota) for NORTHBOUND Stock Connect in August 2024 -- every Northbound channel's net_flow field says so explicitly rather than returning null as if it were real data; gross turnover is unaffected and is published daily for every channel. Southbound net flow is still disclosed by Hong Kong Exchanges and Clearing and is returned when available. A turnover-ranked top-10-stocks list for Northbound depends on an Eastmoney report that has returned a server error on every live probe during this build -- the tool still attempts it live on every call and reports plainly under top_traded_stocks.northbound whether real data came back, rather than silently omitting the field or faking rows. Source: Shanghai Stock Exchange / Shenzhen Stock Exchange / Hong Kong Exchanges and Clearing, via Eastmoney datacenter (keyless).
ashares_unlock_calendar date, from, to, symbol, sort, limit
China A-share restricted-share unlock calendar (限售股解禁): which stocks have locked-up shares becoming tradable on a given day or date range, ranked by unlock market value or by share of float. Answers "today's unlock list", "解禁日历", "限售股解禁 2026-11-06 top 10 by market value", "how many stocks unlock next week", "when does 603376 unlock", "解禁市值排名". Each unlock has the stock, unlock date, restricted-share type (e.g. first-day original-holder shares, IPO strategic placement, private-placement shares), shares unlocking, market value at the latest price in CNY, percent of total shares and percent of the pre-unlock tradable float, number of holder batches, and the stock's price change over the 20 trading days before and after. Also returns the per-day total: number of unlocking stocks and their combined market value. Give `date`, or `from` and `to` (max 31 days), or neither for today; `symbol` (6-digit code) lists that stock's unlock dates. Source: Eastmoney datacenter, restricted-share unlock report (keyless).
ashares_sw_industries level, date, code, sort, limit
Shenwan (申万) industry index board for a trading day: close, change %, turnover rate, trading amount (unit as published), share of market turnover, P/E, P/B and dividend yield for every Shenwan level-1 (31 industries), level-2 (131) or level-3 (336) industry. Answers "申万一级行业涨跌幅", "Shenwan industry PE PB", "which Shenwan industry rose most on 2026-11-06", "半导体 801081 市盈率 市净率", "SW industry valuation ranking", "行业估值". Filter to one industry with `code` (e.g. 801081 semiconductors, level 2) and rank with `sort`. Up/down stock counts, limit-up counts and 20-day highs per industry are NOT published by this source and are listed under not_provided. Source: Shenwan Hongyuan Research, SW industry index daily publication.
ashares_sw_industry_history code, codes, level, start_date, end_date, limit
Daily HISTORY of Shenwan (申万) industry indices: dated open, high, low, close, change %, trading amount for one industry code, a list of codes, or all 31 level-1 industries (level=1), trimmed to a window. Answers "申万一级行业近120个交易日收盘", "Shenwan industry index closing prices over 60 days", "which Shenwan industries turned strong over 20/60/120 days", "801010 农林牧渔 historical close", "SW index relative strength". Each industry also gets window_return_pct (first to last close, computed). Window: `limit` most recent trading days (default 60) or start_date/end_date. Multi-industry calls fetch each series separately (slow: allow ~30 s for level=1); any series that fails is listed under failed, never dropped silently. For ONE day across all industries with P/E and P/B use ashares_sw_industries. Source: Shenwan Hongyuan Research, SW industry index publication.
ashares_market_overview date, start_date, end_date, days
A-share market-wide DAILY OVERVIEW by date, per exchange and combined: number of listed stocks, trading amount, total market cap, float (tradable) market cap and turnover rate (换手率), for the Shanghai (SSE) and Shenzhen (SZSE) exchanges, all in 100 million CNY (亿元). Answers "A-share daily turnover rate for 60 trading days", "全市场换手率", "沪深流通市值", "A-share total and float market cap on 2026-11-12", "margin balance as a share of float market cap" (divide ashares_margin_financing by float_market_cap_100m_cny), "两市成交额". Pass `date`, or `start_date` + `end_date` (or `days`, default 1 = latest trading day) for a history of one row per trading day, newest first. The SSE turnover rate is the exchange's published float-based figure; the SZSE rate and the combined rate are COMPUTED as trading amount / float market cap and labelled so. Covers stocks only (not funds or bonds). If either exchange cannot be read for a day, that day carries the error and no combined figure rather than presenting half the market as the market. Non-trading days are skipped. Source: Shanghai Stock Exchange and Shenzhen Stock Exchange, daily market overview.
cn_index_valuation index_code, days
Index VALUATION for a China Securities Index Co. (CSI) or SSE index code: the latest trading day's P/E and dividend yield plus roughly the last 20 trading days, dated. Answers "CSI Dividend Index 000922 latest P/E and dividend yield", "SSE Dividend 000015 valuation", "H30269 dividend low volatility index P/E", "930955 红利低波100 市盈率 股息率", "中证红利指数估值". Returns four published figures per day: P/E1 (total shares), P/E2 (calculation shares), D/P1 (dividend yield on total shares, %) and D/P2 (dividend yield on calculation shares, %). NOT in this source, and never estimated: P/B (市净率) and valuation percentile / history rank (估值分位) -- the response lists them under not_provided. Code is case-sensitive upstream: numeric codes as 6 digits (000922, 000300, 930955), letter-prefixed ones with an upper-case letter (H30269). An unknown or unpublished code returns found:false. Source: China Securities Index Co., daily index indicators.
cn_index_constituents index_code, limit
CONSTITUENTS and WEIGHTS of a China Securities Index Co. (CSI) or SSE index by code: every constituent stock with its weight (%), exchange and the file date, the weight total, plus the index's sector weights (CSI level-1 sectors such as Financials 22.6%, Information Technology 19.3%, and level-2 industry groups such as Banks) and its top-10 holdings with their sector. Answers "CSI 300 constituents and weights", "沪深300 成分股 权重", "CSI 300 sector weights", "沪深300 行业权重", "what are the biggest holdings of CSI 500 (000905)", "CSI 1000 constituents 000852". Constituent weights come from the index's daily close-weight publication and are dated by `constituents_as_of`; sector weights and top-10 come from CSI's index page data and carry their own `sector_weights_as_of` (the two can differ by days). Per-constituent sector is published only for the top 10; for the rest use the stock's own profile. Code is case-sensitive upstream: numeric codes as 6 digits (000300, 000905, 000852, 000016), letter-prefixed ones upper-case (H30269). An unknown or unpublished code returns found:false. Source: China Securities Index Co., index constituent weights and sector weights.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Install facts
| License | MIT |
|---|---|
| Needs | node >=18 |
| Source | github.com/pipeworx-io/mcp-china-stocks |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-yISleV0qQCTMGYN9yRe6xrNnu6xGTKbMcs9C8FiRUBvu2HstaiQPRuNbZmxzIjMzGEVAx+tdFpHBgG45OIflQg== |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/%40pipeworx/mcp-china-stocks)
New version out? Ask for a fresh report.