get_klines
Get normalized K-line rows for charting.
LABSCO SUMMARY
Three sources behind one call, and a tool that tells you which one answered.
Free market feeds go down individually and quietly; the automatic fallback is what keeps a quote coming back, and the inspection call is what lets you find out why a number looks odd instead of guessing at it.
What it is
A stock quote tool in TypeScript with a zero-dependency runtime, usable from Node, a browser, the command line or as an MCP server. It reads public market feeds from Tencent, Sina and East Money, and by default falls back between them automatically rather than failing when one is down.
What you get
- One normalised quote by code, and a batch of them in a single call
- K-line rows ready for charting, with the period, the count and the price adjustment set on the call
- Symbol search by keyword, for when you have the company name rather than the code
- An inspection call that reports which providers answered and how the fallback resolved — the diagnostic for when a quote looks wrong
- A specific source forced per call when you want Tencent, Sina or East Money rather than whichever answers first
- A-share, Hong Kong and US codes handled through the same SH, SZ, HK and US prefixes
Requirements
Node.js 18 or newer and network access to the upstream feeds. Run over stdio from npm as stock-api with the mcp subcommand; no key and no account, because the sources are public endpoints. That is also the limit worth knowing: the project states plainly that it does not guarantee the accuracy, completeness, timeliness or continued availability of third-party data, gives no investment advice, and asks you to check each source's own terms before commercial, high-frequency or production use.
Setup effort
One command — npx -y stock-api mcp
USE CASES
01
Checking where a stock is right now
Ask by code and get a normalised quote, whichever of the three sources happens to be answering.
02
Reading a whole watchlist at once
Pass the codes together rather than one call per line, and compare them in the same answer.
03
Looking at the trend rather than the price
Pull K-line rows for the period and count you want, with the adjustment applied, ready to chart or summarise.
04
Finding the code for a company you can only name
Search by keyword and take the symbol from the results before asking for the quote.
05
Working out why a number looks wrong
Inspect the code to see which providers responded and how the fallback resolved, then force the source you trust.
5 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_stock
Get one normalized stock quote by code.
get_stocks
Get normalized stock quotes for multiple codes.
inspect_stock
Inspect quote availability and provider fallback details.
search_stocks
Search stock symbols by keyword.
BEFORE YOU INSTALL
What to know first
Tools you get
5 tools when we connected.
Requires
- npx on PATH
- Node.js 18 or later
Where it runs
All 3 documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 5 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx -y stock-api mcpMCP Clients
Claude Desktop, Cursor, Cherry Studio
JSON
{
"mcpServers": {
"stock-api": {
"command": "npx",
"args": [
"-y",
"stock-api",
"mcp"
]
}
}
}
