kronos-mcp
Stock price forecasting for your AI agent — China A-shares.
An MCP server wrapping Kronos, a K-line
time-series model. Ask it for a symbol, get the next N daily candles predicted:
open / high / low / close / volume.
Coverage is China A-shares only. Verified 2026-09-10: AAPL, AAPL.US,
NASDAQ:AAPL, 00700 and 0700.HK all return 404 — the upstream has no
K-line data for them. This is a data limitation, not a symbol-format issue.
| Tool | What it does |
|---|
kronos_health() | Check the service is reachable and your key works. Call this first when something fails. |
kronos_predict(symbol, pred_len) | Predict the next pred_len daily candles (1–30, default 10) |
kronos_predict also returns expected_return — last predicted close over last
real close, minus one. That ratio is the number most people actually want.
Quick start
You need an API key first — see below.
Claude Desktop / Cursor
Add to claude_desktop_config.json:
{
"mcpServers": {
"kronos": {
"command": "uvx",
"args": ["kronos-mcp"],
"env": { "KRONOS_API_KEY": "oapk_xxx" }
}
}
}
Command line
KRONOS_API_KEY=oapk_xxx uvx kronos-mcp
pip install kronos-mcp
KRONOS_API_KEY=oapk_xxx kronos-mcp
API key
This server has no keyless mode, and cannot have one — the upstream returns
401 without a key.
The reason is cost, not gatekeeping: Kronos runs on our own GPUs and a single
inference takes 30–70 seconds. Open anonymous access would let a handful of
loops saturate the service, with no way to tell who is doing it.
Get one:
- Open https://hunter.agentpit.io/dev/api-keys and sign in
- Click 申请 API Key and choose API type KRONOS
- Copy the
oapk_… key — it is shown once
- Set it as
KRONOS_API_KEY
Approval usually lands within hours on a business day. Free, with a default
quota of 1000 calls per key.
If the key is missing, this server does not return sample data or a fake
success. It returns an error that tells you exactly where to get a key.
Environment variables
| Variable | Default | Notes |
|---|
KRONOS_API_KEY | — | Required. oapk_ key of type KRONOS |
KRONOS_URL | https://kronos.agentpit.io | Point this at your own deployment if you self-host |
KRONOS_TIMEOUT | 180 | Seconds. GPU inference is 30–70s — don't set this tight |
KRONOS_MCP_TRANSPORT | stdio | stdio | streamable-http | sse |
KRONOS_MCP_HOST / KRONOS_MCP_PORT | 0.0.0.0 / 8932 | Remote transports only |
stdio is what Claude Desktop, Cursor and uvx use. Run a remote transport
only if you want one long-running server serving several clients — and note the
MCP spec marks SSE as deprecated, so prefer streamable-http for new setups.
What to expect
Every call takes 30–70 seconds. That is the GPU, not a hang. Don't retry
because it feels slow, and don't loop it over dozens of symbols — upstream takes
one symbol per request.
This is a statistical extrapolation, not investment advice. The model reads
price history and nothing else: no news, no halts, no earnings dates. It will
drift badly in unusual conditions. Treat the output as one input among many.
Errors you might hit
| Error | Meaning |
|---|
missing_api_key | KRONOS_API_KEY not set — see API key |
invalid_api_key (401) | Key wrong, incomplete or revoked. Revocation takes up to 5 min to propagate |
wrong_key_type (403) | Key is valid but isn't a KRONOS key — you may have applied for KPRED or FIN_R1 |
symbol_not_found (404) | Use 600519 or 600519.SH. A-shares only — US and HK tickers land here |
rate_limited (429) | Per-IP cap on invalid keys, or your quota is exhausted |
upstream_down (502/504) | GPU service restarting. If it lasts more than a few minutes, please open an issue |
- truesource-mcp — verifiable first-hand market signals: filings, procurement wins, macro data
- akshare-mcp — lets a model explore AKShare's 1000+ China market data functions on its own
- hunter-community — the open-source stack these come from
Apache-2.0.