
CNEquity MCP Server: Setup for Claude, Cursor and Other Apps
Lets Claude, Cursor and other AI apps query China A-share prices, financial statements and capital flows from a data lake on your computer.
CNEquity builds a local copy of China A-share data: prices, financial statements, corporate events and fund flows. Its MCP command, cne mcp, hands that copy to your AI app read-only. It runs on your computer and needs no account or token.
You must build the data first. A sample lake takes about a minute and the full market can take hours. A --live option skips the lake and fetches data on request, but it only supports stock lookup and unadjusted daily bars.
Good for
- Researchers studying China A-shares who want to ask questions in plain English
- Quant developers who need point-in-time financials for backtests
- Small teams that want one local copy of market data for AI agents
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install CNEquity MCP
Claude Code
- 1
Copy this prompt.
Add the CNEquity MCP server to Claude Code. Run this command: claude mcp add cnequity -- cne mcp --config /abs/path/to/cnequity.toml Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Python 3.10+, pip install cnequity, A lake from cne init.
Install the package first with pip, then build a sample lake with cne init --profile demo (about a minute) or the full lake with cne init (can take hours). Replace the config path with the absolute path of your own cnequity.toml. If the app cannot find cne, use the full path from which cne.
From the project README. Source.
Tools
Shows what data your lake holds and how to read it
Lists the datasets in your local lake, how far back each one goes, and the rules that make answers correct, such as price adjustment and point-in-time data. The project says to call it first in every session.
Try: “What data do I have in the lake, and how far back does it go?”
Files ·
describe_lakeTurns a stock name into its code
Looks up a company name, such as Moutai, and returns its stock code, such as 600519.SH. Delisted stocks are included and flagged with a delist date.
Try: “What is the stock code for CATL?”
Files ·
resolve_symbolReads daily, index and minute price bars
Returns price bars for stocks and indexes. You can pick price adjustment and the stock universe, and it warns you when you ask without choosing an adjustment.
Try: “Which day had CATL's highest close in the last 30 trading days?”
Files ·
query_barsReads financial statements as they were known on a date
Returns financial statement items as of a date you must give, so a historical question is not answered with today's restated numbers. Rows added by a later backfill are marked as not exact.
Try: “Show Kweichow Moutai's net profit as it was known on 2024-03-31.”
Files ·
query_fundamentalsReads any other dataset by date and symbol
Reads any other registered dataset, such as fund flows, margin balances, dragon-tiger lists or share unlock schedules, filtered by date window and stock symbols, a page at a time.
Try: “Show northbound fund flows for the last 10 trading days.”
Files ·
query_datasetRuns one read-only SQL query across the whole lake
Runs a single DuckDB SELECT over all datasets for rankings, averages and joins, so the assistant does not page rows through the chat. It rejects anything that is not a single SELECT and limits file access to the lake folders.
Try: “Rank the 10 stocks with the largest 5-day gain in the last month.”
Files ·
run_sql
Read from the source code
Permissions
low risk · 4 things to watch
Low risk
The six tools only read from your local lake, and the server cannot change or delete data. If you use the HTTP mode with a public tunnel, the URL token is the only protection, so keep it private.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
HTTP mode with a tunnel exposes your data
For ChatGPT you run an HTTP mode and a public tunnel, and the token sits in the URL. Anyone with that URL can run read-only SQL on your lake, so keep it private and stop the tunnel when done. github.com
Vendor news text sits in the lake
The lake holds news_headlines and flash_news_wire, which are third-party text the assistant reads. The project says SQL can be influenced by content ingested into the lake. run_sql accepts only a single SELECT and is limited to the lake folders, but the project says this is not an operating-system sandbox. github.com
Live mode fetches data on demand
With the live option, lookups and daily-bar requests are fetched from data sources on the spot without writing to disk. Answers there are unadjusted, so use the full lake for price history. github.com
Data comes from third-party sources
The lake is built from public market data sources, and the project lists source limits and history horizons in its dataset notes. Check coverage before relying on it. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | The MCP server is read-only by design: all six tools carry readOnlyHint and the server has no way to fetch, retry or clean up data. |
|---|---|
| Talks to | Market data sources, only when you build the lake or use the live option |
| Sign-in and keys | No account or token for stdio. The optional HTTP mode takes a token you generate. |
| Scopes |
|
Questions
Is the CNEquity MCP server official?
It is made by the CNEquity project (rootSunc) for its own data lake, not by a stock exchange or data vendor. China A-share data is not published by it; the lake collects data from public sources.
Do I need an account or API key?
No. The project says no account or token is needed. You install the package, build a lake with cne init, and point your app at it.
Can it change or delete data?
No. The MCP command is read-only: all six tools carry a read-only flag and nothing in it triggers fetching or cleanup. SQL is limited to a single SELECT.
Do I need to build the data lake first?
Yes, unless you use the live option. The sample lake takes about a minute, and the full A-share lake can take hours. The server stops with a message if the lake has no data.
Can I use it with ChatGPT?
Yes, with extra steps. ChatGPT needs a public HTTPS address, so you run the HTTP mode with a token, open a tunnel, and add a connector in developer mode, which needs a paid plan.
What is the difference between the lake and live mode?
Live mode fetches on request and only supports stock lookup and unadjusted daily bars. The lake supports price adjustment, point-in-time financials and all other datasets.
Which version was checked, and does a newer one add tools?
The six tools were read at v0.20.0. The latest release is now v0.22.0 (PyPI 0.22.0), and its MCP tool catalog, protocol and HTTP files are unchanged from v0.20.0. Check the project's release notes before relying on newer behavior.
Information
updated Nov 2, 2026
- Publisher
- Community
- Package
cnequity- Registry
- PyPI
- Transport
- stdio
- Auth
- None
- Version
- 0.20.0
- License
- Apache-2.0
- Last commit
- Oct 25, 2026
- Open issues
- 2
- Listed in
- Official MCP registry
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 3Hide
- github.com · github.com
- github.com · github.com
- github.com · github.com