
AKTools MCP Server: Chinese Market Data for Claude and Cursor
Lets Claude, Cursor and other assistants look up stock, futures, fund, bond and macro data from AKShare.
This server is made by the team behind AKShare, the open source finance data library. It has three tools that search the more than a thousand AKShare data feeds, explain their parameters and fetch the data. It runs on your computer and starts by itself when your assistant needs it. No account or API key is needed.
The data comes from public web sources and is for research only, not investment advice. The README is in Chinese, and the first launch downloads about 150 MB of dependencies.
Good for
- Analysts and students who want Chinese market data pulled into a chat by asking in plain words
- Developers who want the assistant to find the right AKShare interface and parameters for them
- Researchers who already use AKShare and want quick one-off lookups without writing a script
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 AKTools MCP
Claude Code
- 1
Copy this prompt.
Add the AKTools MCP server to Claude Code. Run this command: claude mcp add aktools -- uvx --from aktools aktools-mcp 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 uv (Python).
Read-only mode: Nothing to turn off: all three tools only read data.
Install uv first. The first start downloads about 150 MB of dependencies, so give it a few minutes. The terminal command comes from the README; the project .mcp.json is our adaptation.
From the project README. Source.
Tools
Finds the data feeds that match your keywords
Searches AKShare's catalog of more than a thousand financial data feeds by keyword, such as "A-share daily" or "futures positions". It returns the best matches first, up to 50, with their names, titles and categories.
Try: “Which AKShare interfaces cover convertible bonds?”
Read ·
search_interfacesShows what a data feed needs and what it returns
Gives the title, data source, each parameter with its default and type, the returned columns and a usage example for one feed. The assistant uses it to fill in the right parameters.
Try: “What parameters does stock_zh_a_hist take?”
Read ·
describe_interfaceFetches rows of financial data from a feed
Calls the chosen feed with your parameters and returns up to a set number of rows, 100 by default, with the total row count. You can page forward or count back from the end to get the latest rows.
Try: “Get Kweichow Moutai daily prices, forward-adjusted, for October 8 to 11, 2024”
Network ·
get_data
Read from the source code
Permissions
low risk · 3 things to watch
Low risk
All three tools only read public market data, so the main risk is acting on wrong or stale numbers. Treat the data as research input and check it before you trade on it.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
Data is for research, not investment decisions
The project says the data comes from public sources, may be wrong, and is not investment advice. Check numbers before you rely on them. github.com
Each lookup calls public finance sites
The server fetches data from the sites behind each feed, and your requests are visible to them. Their terms of use apply. github.com
The separate web mode is for your own machine
If you run the HTTP service instead, it listens on 127.0.0.1 unless you pass another host. Only open it to your network with a token. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | All three tools are marked read-only in the source, so there is nothing to switch off. |
|---|---|
| Talks to | The public web data sources behind each AKShare feed |
| Sign-in and keys | No sign-in or key. An access token is only used if you run the separate HTTP service with --token. |
Questions
Is the AKTools MCP server official?
Yes, in the sense that the AKShare team builds it. It comes from the akfamily organization, which makes AKShare. The data itself comes from public web sources, not from the exchanges.
Is it free? Does it need an API key?
It is free under the MIT license and needs no account or key. The data sources behind it are public websites.
What do I need installed?
The uv tool, which runs the server without a separate install. Python 3.11 or later is required, and the first start downloads about 150 MB of dependencies, which can take a few minutes.
What data does it cover?
More than a thousand AKShare feeds covering stocks, futures, options, funds, bonds, foreign exchange and macro data. Ask the assistant to search for a topic and it will list the matching feeds.
Can it change anything?
No. All three tools only read data, and the source marks them read-only. Large results are cut to a set number of rows per call.
Can I run it as a web service instead?
Yes. Run python -m aktools and point your assistant at the /mcp path of that service. This helps if several computers share one service. It listens on 127.0.0.1 by default.
Why is the README in Chinese?
The project is written mainly for Chinese users. The README opens with one English line, and the setup is the same uvx config used by other servers. Prompts can be in English.
Information
updated Nov 2, 2026
- Publisher
- Official
- Package
aktools- Registry
- PyPI
- Transport
- stdio, Streamable HTTP
- Auth
- None
- Version
- 0.1.3
- License
- MIT
- Last commit
- Oct 30, 2026
- Open issues
- 0
- 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 2Hide
- AKTools README · github.com
- AKTools MCP server source · github.com