# CNEquity MCP server

> Query a local China A-share data lake of prices, fundamentals, fund flows and events with point-in-time semantics.

- Listing: https://mcp.tc/i/cnequity
- Connect: this is a local (stdio) server; install it on your machine (see Install). The listing link is a page, not an MCP endpoint.
- Type: local (stdio)
- Auth: no API key needed
- Category: [Finance & Payments](https://mcp.tc/c/finance-payments)
- Vendor: rootSunc
- Homepage: <https://rootsunc.github.io/CNEquity/reference/mcp/>
- Docs: <https://rootsunc.github.io/CNEquity/>
- Repository: <https://github.com/rootSunc/CNEquity>
- Package: pypi `cnequity`

## About

CNEquity organizes China A-share market data into a local Parquet data lake with 55 daily-updated datasets. They cover stock prices, fundamentals, futures and options, fund flows, company announcements, index and industry membership, macro data and regulatory events. Rows carry source and version information, and adjustment factors, historical constituents and point-in-time queries are built in. The MCP server gives assistants read-only access to this lake.

It runs locally over stdio from the PyPI package cnequity (Python 3.10+, started with the cne mcp command). You first build the lake with cne init. No account, API key or token is needed for basic collection, although some supplementary data sources need your own credentials. An HTTP mode with a token is available for clients that only accept public URLs.

## What it can do

- Query daily bars with forward or backward price adjustment
- Look up financial statements with strict point-in-time as\_of filtering
- Read fund flow, northbound, margin trading and dragon-tiger list data
- Browse index constituents and industry membership history
- Inspect futures and options contracts and prices
- Read announcements, news and regulatory events

## Example prompts

- "What was CATL's highest closing price over the last 30 trading days?"
- "Which financials for 600519.SH were publicly known as of 2024-06-30?"
- "Show northbound fund flows for the past week."
- "List index constituents of the CSI 300 as of the start of 2023."

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

```bash
claude mcp add --transport stdio cnequity -- uvx cnequity mcp --config /path/to/configs/cnequity.toml
```

2. Start Claude Code and type `/mcp`. **cnequity** should show as connected.

Add `--scope user` to make it available in every project.

### Claude Desktop

1. Open **Settings → Developer → Edit Config**. It opens `claude_desktop_config.json`. Add:

`claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "cnequity": {
      "command": "uvx",
      "args": [
        "cnequity",
        "mcp",
        "--config",
        "/path/to/configs/cnequity.toml"
      ]
    }
  }
}
```

2. Save the file and restart Claude Desktop.

Needs uv (Python) on your computer. The file lives in `~/Library/Application Support/Claude/` on macOS and `%APPDATA%\Claude\` on Windows.

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=cnequity&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJjbmVxdWl0eSIsIm1jcCIsIi0tY29uZmlnIiwiL3BhdGgvdG8vY29uZmlncy9jbmVxdWl0eS50b21sIl19>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

```json
{
  "mcpServers": {
    "cnequity": {
      "command": "uvx",
      "args": [
        "cnequity",
        "mcp",
        "--config",
        "/path/to/configs/cnequity.toml"
      ]
    }
  }
}
```

Needs uv (Python) on your computer.

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=cnequity&config=%7B%22type%22%3A%22stdio%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22cnequity%22%2C%22mcp%22%2C%22--config%22%2C%22%2Fpath%2Fto%2Fconfigs%2Fcnequity.toml%22%5D%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"cnequity","type":"stdio","command":"uvx","args":["cnequity","mcp","--config","/path/to/configs/cnequity.toml"]}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

```json
{
  "servers": {
    "cnequity": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "cnequity",
        "mcp",
        "--config",
        "/path/to/configs/cnequity.toml"
      ]
    }
  }
}
```

Needs uv (Python) on your computer.

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

```json
{
  "mcpServers": {
    "cnequity": {
      "command": "uvx",
      "args": [
        "cnequity",
        "mcp",
        "--config",
        "/path/to/configs/cnequity.toml"
      ]
    }
  }
}
```

2. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf.

### Codex

```bash
codex mcp add cnequity -- uvx cnequity mcp --config /path/to/configs/cnequity.toml
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.cnequity]
command = "uvx"
args = ["cnequity", "mcp", "--config", "/path/to/configs/cnequity.toml"]
```

Needs uv (Python) on your computer.

### Gemini CLI

```bash
gemini mcp add cnequity uvx -- cnequity mcp --config /path/to/configs/cnequity.toml
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients that start local servers accept this shape:

```json
{
  "mcpServers": {
    "cnequity": {
      "command": "uvx",
      "args": [
        "cnequity",
        "mcp",
        "--config",
        "/path/to/configs/cnequity.toml"
      ]
    }
  }
}
```

Zed puts servers under `context_servers` in its settings, with the same `command`, `args` and `env` fields.

Needs uv (Python) on your computer.

## Recent changes

- 2026-11-13 23:33 UTC: New version 0.24.0 (was 0.23.0), read from PyPI. Source: automatic check.
- 2026-11-06 23:23 UTC: New version 0.23.0 (was 0.22.0), read from PyPI. Source: automatic check.
- 2026-11-02 23:25 UTC: New version 0.22.0 (was 0.21.0), read from PyPI. Source: automatic check.
- 2026-10-31 17:26 UTC: New version 0.21.0 (was 0.20.0), read from PyPI. Source: automatic check.
- 2026-10-25 11:30 UTC: New version 0.19.0 (was 0.18.0), read from PyPI. Source: automatic check.

More on the History tab, with descriptions before and after for the newest entries: https://mcp.tc/i/cnequity#history (Atom feed: https://mcp.tc/i/cnequity/history.xml). It records what mcp.tc's anonymous checks saw, every 3 hours where the tool list can be read without sign-in; it is not a security review.

## Details

- Server version: 0.24.0
- Last checked: 2026-10-18
- Listed: 2026-10-18
- Updated: 2026-10-26

---
Source: https://mcp.tc/i/cnequity (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
