Skip to content
MCP server

China Stocks

Live China A-share market data for AI agents: quotes, limit-up boards, flows and margin

Install
Pricing
Freemium
Platforms
API, CLI
Runs
Locally or Remotely
Version
0.2.1
Listing updated
today

Similar MCP servers

About China Stocks

China Stocks is a freemium MCP server for finance and payments. It can run locally on your machine or as a hosted remote server.

The README says this server covers the Shanghai, Shenzhen, STAR and ChiNext exchanges, with real-time quotes, intraday minute bars, daily OHLCV history and technical indicators. It also tracks the daily limit-up and limit-down boards, market-wide margin financing balances, turnover rankings, and company earnings guidance with analyst consensus.

The tools are backed by public Eastmoney, Sina, Tencent and exchange endpoints, and the listing notes that several of them can be intermittent. Responses carry date and staleness fields so an agent can tell when data was last refreshed or when a day has no published figures.

It suits quantitative researchers, analysts and developers building agents that need China equity market context. The page describes it as an unofficial integration, not affiliated with the upstream data providers.

Install

Run in a terminal

claude mcp add --transport http china-stocks https://gateway.pipeworx.io/china-stocks/mcp

Add to Settings → Connectors → Add custom connector

https://gateway.pipeworx.io/china-stocks/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "china-stocks": {
      "url": "https://gateway.pipeworx.io/china-stocks/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "china-stocks": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/china-stocks/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "china-stocks": {
      "serverUrl": "https://gateway.pipeworx.io/china-stocks/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "china-stocks": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/china-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 (12)

Taken from the project documentation; the running server may differ.

ashares_market_snapshot
Headline index levels plus limit-up and limit-down counts.
ashares_limit_up
Daily limit-up board with ranked pool.
ashares_limit_down
Daily limit-down board with ranked pool.
ashares_margin_financing
Market-wide or per-stock margin financing and securities lending balance.
ashares_capital_flow
Daily main-capital net inflow history for a stock.
ashares_quote
Real-time quotes by 6-digit code.
ashares_daily_history
Daily OHLCV history for up to 20 codes.
ashares_intraday_bars
Intraday minute bars for a past trading day.
ashares_turnover_ranking
Market-wide ranking by turnover, change % or volume.
ashares_earnings_forecast
Company earnings guidance for a stock.
ashares_analyst_consensus
Analyst consensus estimates per forecast year.
ashares_stock_connect
Stock Connect daily channel turnover.

What it does

Limit-up and limit-down boards
Daily ranked pools of stocks hitting their price limits, with consecutive-board counts and turnover.
Quotes and minute bars
Real-time quotes and intraday bars for past trading days, with cumulative volume and turnover.
Technical indicators
Moving averages, Bollinger Bands, MACD and KDJ computed from daily price history.
Capital flow and dragon-tiger data
Main-capital net inflow history and daily dragon-tiger list seat net-buy amounts.
Margin and Stock Connect data
Market-wide margin financing balances and Northbound and Southbound Stock Connect turnover.
Earnings and analyst data
Company earnings guidance and analyst consensus estimates for A-share companies.

Good for

  • Track daily limit-up and limit-down sentiment across the A-share market
  • Pull daily price history with forward or backward adjustment for backtesting
  • Monitor sector main-capital inflows over several trading days
  • Review analyst consensus and earnings guidance before a company update
  • Check margin financing balances for market leverage trends

Pricing

Freemium, from $49 a month

Free to use anonymously with daily caps; free account raises the cap; paid credits and subscriptions for higher volume.

Prices change. Check pipeworx.io before you buy.

China Stocks FAQ

Does the server require an API key?

The README says it is keyless. An optional Pipeworx API key raises the daily call cap from anonymous limits to a higher free allowance.

How far back does intraday minute data go?

It depends on bar size. The README gives roughly 8 trading days at 1-minute, 40 at 5-minute (default), 110 at 15-minute, a year at 30-minute and two years at 60-minute.

Is Northbound daily net flow available?

No. The README says mainland regulators stopped publishing daily Northbound net fund-flow figures in August 2024, so those fields say so explicitly rather than returning values.

Is China Stocks free?

China Stocks has a free plan, with paid plans for more usage or features. Paid plans start at $49 a month.

How do I add China Stocks to Claude Code?

Run this command in your terminal: claude mcp add --transport http china-stocks https://gateway.pipeworx.io/china-stocks/mcp

What are the best alternatives to China Stocks?

The closest alternatives to China Stocks are Wudao A-Share Stock Data MCP, A股数据 API (A-Share Data API), hhxg A-share Market Data, AStockEvent and MCP Stock Analyst.

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.

How AIPoweredBot checks servers