Kronos

io.github.hangeaiagentPublished by GitHub account hangeaiagentv0.1.2Updated Oct 24, 2026

Stock price forecasting for China A-shares — Kronos K-line time-series model

VerifiedSTDIODesktop onlyFinanceAI & ML

Overview

AI-generated overview

Kronos wraps a K-line time-series model so an assistant can forecast the next daily candles for China A-share symbols.

What you can do
Check service reachability and API key validity with a health tool, recommended first when something fails. Predict the next 1 to 30 daily candles (open, high, low, close, volume) for a China A-share symbol, defaulting to 10. Receive an expected return figure computed from the last predicted close versus the last real close.
When to use it
Use it when you want a statistical extrapolation of recent price history for a China A-share ticker, as one input among others. It is not suited to US or Hong Kong tickers, which return not-found errors.
Requirements
Runs locally as a Python package via uvx or pip, with a KRONOS_API_KEY of type KRONOS from the provider's developer portal (approval usually within hours on a business day, free with a default quota of 1000 calls). Optional KRONOS_URL, KRONOS_TIMEOUT and transport settings. Network access to the upstream service is required.
Before you install
The API key is required, shown only once, and there is no keyless mode. Each call takes 30 to 70 seconds of GPU inference, so avoid retries and loops over many symbols. Output is a statistical extrapolation from price history only, not investment advice, and can drift badly in unusual conditions.

Installation

In SourceWeft

  1. Open Kronos in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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.

[License]

Tools

ToolWhat 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:

json
{  "mcpServers": {    "kronos": {      "command": "uvx",      "args": ["kronos-mcp"],      "env": { "KRONOS_API_KEY": "oapk_xxx" }    }  }}

Command line

bash
# no install neededKRONOS_API_KEY=oapk_xxx uvx kronos-mcp
# or install itpip install kronos-mcpKRONOS_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:

  1. Open https://hunter.agentpit.io/dev/api-keys and sign in
  2. Click 申请 API Key and choose API type KRONOS
  3. Copy the oapk_… key — it is shown once
  4. 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

VariableDefaultNotes
KRONOS_API_KEY—Required. oapk_ key of type KRONOS
KRONOS_URLhttps://kronos.agentpit.ioPoint this at your own deployment if you self-host
KRONOS_TIMEOUT180Seconds. GPU inference is 30–70s — don't set this tight
KRONOS_MCP_TRANSPORTstdiostdio | streamable-http | sse
KRONOS_MCP_HOST / KRONOS_MCP_PORT0.0.0.0 / 8932Remote 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

ErrorMeaning
missing_api_keyKRONOS_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

Related

  • 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.

Source: tools/kronos-mcp/README.md at commit 4af6d96

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts