# CNEquity

> CNEquity is an open-source MCP server for finance and payments. Read-only access to a local China A-share data lake for stock research. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Website:** https://rootsunc.github.io/CNEquity/reference/mcp/
- **Repository:** https://github.com/rootsunc/cnequity
- **MCP Registry name:** io.github.rootSunc/cnequity
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

CNEquity keeps 86 datasets of China A-share data as local Parquet files, and its `cne mcp` command lets an AI client query them without any way to trigger collection, retries or cleanup. Data covers prices, financial statements, capital flows, company events and futures, with delisted stocks retained and financial reports kept point-in-time by announcement date.

The server offers six tools, split by the shape of the question rather than by dataset. Correctness rules travel inside responses: price queries without an adjustment setting return a warning, and fundamentals queries refuse to run without an as-of date, since defaulting to today would answer a historical question with later information. Heavy reads above four million rows without a narrow symbol list are rejected, and the response names the latest date window that fits.

It works over stdio with Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code and others. ChatGPT needs an HTTP mode with a token and an HTTPS tunnel. A live mode fetches data on demand without writing it to disk. The project is 0.x, has no backtesting engine or order placement, and the code is Apache-2.0 while the data stays under upstream licences.

## Features

- **Six question-shaped tools:** Describe, resolve symbols, bars, fundamentals, other datasets and SQL, instead of one tool per dataset.
- **Point-in-time fundamentals:** Financial statement queries require an as-of date to avoid look-ahead bias.
- **Contract in responses:** Adjustment, universe and coverage rules are returned with results, not just documented.
- **Row limits with guidance:** Oversized reads are refused and the response suggests a window that fits.
- **Delisted stocks kept:** Historical universes include delisted names, flagged with a delist date.
- **Live mode:** Fetch data on demand without building a local lake.

## Good for

- Ask for the highest closing price of a stock over recent trading days
- Look up which financial data was known on a rebalance date
- Rank sectors by capital flow using a DuckDB query
- Resolve a Chinese company name to its ticker
- Prototype quant research before building a full local lake

## Install

### Claude Code (Terminal)

```sh
claude mcp add cnequity -- uvx cnequity
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "cnequity": {
      "command": "uvx",
      "args": [
        "cnequity"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "cnequity": {
      "command": "uvx",
      "args": [
        "cnequity"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "cnequity": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "cnequity"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "cnequity": {
      "command": "uvx",
      "args": [
        "cnequity"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "cnequity": {
      "command": "uvx",
      "args": [
        "cnequity"
      ]
    }
  }
}
```

## Tools

- `describe_lake`: Reports what the lake contains, its coverage and the conventions that make answers correct.
- `resolve_symbol`: Maps a company name to its ticker, including delisted stocks with a delist date.
- `query_bars`: Reads daily, index and minute bars with adjust and universe options.
- `query_fundamentals`: Reads financial statement items; requires an as-of date for point-in-time results.
- `query_dataset`: Reads any other dataset filtered by date and symbol.
- `run_sql`: Runs a single read-only DuckDB SELECT for aggregation and ranking.

## FAQ

### Can the AI trigger data collection through MCP?

No. The MCP interface is read-only and has no entry point for collection, retries or cleanup.

### How do I try it without building the full lake?

Run cne init --profile demo to fetch a small slice of real data, or use the --live option.

### Does it work with ChatGPT?

Yes, in HTTP mode with a token and an HTTPS tunnel, and it needs developer mode on a paid plan.

### Is there a backtesting engine?

No. The project does not include backtesting or order placement.

### Is CNEquity free?

Yes. CNEquity is open source, so you can use and self-host it for free.

### How do I add CNEquity to Claude Code?

Run this command in your terminal: claude mcp add cnequity -- uvx cnequity

### What are the best alternatives to CNEquity?

The closest alternatives to CNEquity are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

## Alternatives

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/cnequity
