Kronos — Claude Code MCP server: forecasts and setup
Kronos predicts upcoming daily candles for China A-shares. Use it when an agent needs a price-history forecast with an expected return value.
claude mcp add --env KRONOS_API_KEY=<KRONOS_API_KEY> --env KRONOS_URL=<KRONOS_URL> --env KRONOS_TIMEOUT=<KRONOS_TIMEOUT> --transport stdio kronos-mcp -- uvx kronos-mcpWhat Kronos does
Kronos wraps the Kronos K-line time-series model as an MCP server. Give it a symbol and pred_len, and it returns the next daily candles with open, high, low, close, and volume. The kronos_health tool checks service access and the API key; kronos_predict runs the forecast and also returns expected_return, based on the last predicted close versus the last real close.
The server needs a KRONOS API key in KRONOS_API_KEY; you can request one at https://hunter.agentpit.io/dev/api-keys. Claude Code starts it with uvx kronos-mcp through claude mcp add. Without KRONOS_API_KEY, the server returns an error. Each request takes 30–70 seconds, and the model reads price history only, so it does not account for news, trading halts, or earnings dates. Coverage is limited to China A-shares.
What it helps with
- forecast the next daily candles for a stock symbol
- inspect expected return from the predicted close
- check whether the service and API key work
- separate supported China A-shares from US or HK tickers
Example prompts for the agent
- Check the service and my API key with
kronos_health. - Use
kronos_predictto forecast the next 10 daily candles for600519. - Forecast 5 candles for
600519.SHand show theexpected_return.
How to install Kronos
Platform CLI
claude mcp add --env KRONOS_API_KEY=<KRONOS_API_KEY> --env KRONOS_URL=<KRONOS_URL> --env KRONOS_TIMEOUT=<KRONOS_TIMEOUT> --transport stdio kronos-mcp -- uvx kronos-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from kronos-mcp <command>
Platform CLI
codex mcp add kronos-mcp --env KRONOS_API_KEY=<KRONOS_API_KEY> --env KRONOS_URL=<KRONOS_URL> --env KRONOS_TIMEOUT=<KRONOS_TIMEOUT> -- uvx kronos-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from kronos-mcp <command>
Config file
{
"mcpServers": {
"kronos-mcp": {
"command": "uvx",
"args": [
"kronos-mcp"
],
"env": {
"KRONOS_API_KEY": "<KRONOS_API_KEY>",
"KRONOS_URL": "<KRONOS_URL>",
"KRONOS_TIMEOUT": "<KRONOS_TIMEOUT>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from kronos-mcp <command>
Config file
{
"servers": {
"kronos-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"kronos-mcp"
],
"env": {
"KRONOS_API_KEY": "<KRONOS_API_KEY>",
"KRONOS_URL": "<KRONOS_URL>",
"KRONOS_TIMEOUT": "<KRONOS_TIMEOUT>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from kronos-mcp <command>
Platform CLI
gemini mcp add -e KRONOS_API_KEY=<KRONOS_API_KEY> -e KRONOS_URL=<KRONOS_URL> -e KRONOS_TIMEOUT=<KRONOS_TIMEOUT> kronos-mcp uvx kronos-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from kronos-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Kronos
How do I install Kronos in Claude Code?
Run claude mcp add kronos-mcp -e KRONOS_API_KEY=<KRONOS_API_KEY> -- uvx kronos-mcp.
What does Kronos do?
It forecasts the next daily candles for China A-shares and returns open, high, low, close, volume, plus expected_return.
Does Kronos support US or Hong Kong stocks?
No. The server covers China A-shares only, while symbols such as AAPL and 0700.HK return a 404 error.
