# China Stocks

> China Stocks is a freemium MCP server for finance and payments. Live China A-share market data for AI agents: quotes, limit-up boards, flows and margin. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $49 a month
- **Platforms:** API, CLI
- **Website:** https://pipeworx.io/packs/china-stocks
- **Repository:** https://github.com/pipeworx-io/mcp-china-stocks
- **MCP Registry name:** io.github.pipeworx-io/china-stocks
- **Categories:** [finance and payments](https://ai-powered.com/categories/finance-and-payments), [financial data](https://ai-powered.com/categories/financial-data)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/china-stocks/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "china-stocks": {
      "url": "https://gateway.pipeworx.io/china-stocks/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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.

## Alternatives

- [Wudao A-Share Stock Data MCP](https://ai-powered.com/mcp/wudao-a-share-stock-data-mcp): Wudao A-Share Stock Data MCP is a freemium MCP server for finance and payments.
- [A股数据 API (A-Share Data API)](https://ai-powered.com/mcp/a-api-a-share-data-api): A股数据 API (A-Share Data API) is a freemium MCP server for finance and payments.
- [hhxg A-share Market Data](https://ai-powered.com/mcp/hhxg-a-share-market-data): hhxg A-share Market Data is a paid MCP server for finance and payments.
- [AStockEvent](https://ai-powered.com/mcp/astockevent): AStockEvent is a free MCP server for finance and payments.
- [MCP Stock Analyst](https://ai-powered.com/mcp/mcp-stock-analyst): MCP Stock Analyst is a freemium MCP server for finance and payments.
- [AkTools MCP Server](https://ai-powered.com/mcp/aktools-mcp-server): AkTools MCP Server is an open-source MCP server for finance and payments.
- [WalnutLink A-share Depth Desk](https://ai-powered.com/mcp/walnutlink-a-share-depth-desk): WalnutLink A-share Depth Desk is a freemium MCP server for finance and payments.
- [QuantToGo Reason Index](https://ai-powered.com/mcp/quanttogo-reason-index): QuantToGo Reason Index is an open-source MCP server for finance and payments.

---
Source: https://ai-powered.com/mcp/china-stocks
