Kernel-Hunter/kandle

Connect your agent ·
Script docs ·
Releases ·
简体中文
Kandle is a free, open source charting app for crypto, stocks and forex that runs in your browser. You don't need an account, and Kandle has no server of its own: market data goes from each provider straight to your browser, and your charts, scripts and API keys stay in local storage. It also ships an MCP server, so Claude Code, Codex, Cursor or Gemini CLI can read the chart, draw levels, add indicators and run scripts while you watch.
An agent connected over MCP marks resistance and a support zone, adds RSI and runs an EMA cross script.
## Get started
Open kernel-hunter.github.io/kandle. There is nothing to install, and live crypto data from five exchanges works without a key. Type any letter to search for a symbol, press / for indicators and Alt+S for the script editor.
To run your own copy, see Run it locally.
## Use it with your AI agent
Kandle ships an MCP server, kandle-mcp. Your agent starts it, and the Kandle tab in your browser connects to it over a WebSocket on 127.0.0.1. You need Node.js 22.12 or newer.
For Claude Code:
sh
claude mcp add kandle -- npx -y \
--package=https://github.com/Kernel-Hunter/kandle/releases/download/v0.10.1/kandle-mcp-0.10.1.tgz \
kandle-mcp
Other agents are below. Then ask something like "mark the last swing high and low on BTC and draw a Fibonacci retracement between them".
### Set up
1. Add the server to your agent (the command above, or a snippet below).
2. Ask the agent for the Kandle pairing code. It calls getbridgestatus and shows a code like K7QD-9MXR-2HPA.
3. In Kandle, click Agent in the top bar, paste the code and turn on Agent bridge. The dot on the button turns green when the agent is connected.
The code is saved in your browser and in ~/.kandle/bridge-token, so you only pair once. This works with the hosted app and with a copy you run yourself. With the hosted app, your browser may ask whether the page can reach devices on your local network; allow it so the page can talk to kandle-mcp on 127.0.0.1.
Claude Desktop
Download kandle-mcp-0.10.1.mcpb and open it to install the server.
Codex
In ~/.codex/config.toml:
toml
[mcpservers.kandle]
command = "npx"
args = ["-y", "--package=https://github.com/Kernel-Hunter/kandle/releases/download/v0.10.1/kandle-mcp-0.10.1.tgz", "kandle-mcp"]
Cursor and Gemini CLI
In ~/.cursor/mcp.json (or .cursor/mcp.json in a project) for Cursor, and ~/.gemini/settings.json for Gemini CLI:
json
"mcpServers": {
"kandle": {
"command": "npx",
"args": ["-y", "--package=https://github.com/Kernel-Hunter/kandle/releases/download/v0.10.1/kandle-mcp-0.10.1.tgz", "kandle-mcp"]
Other clients, updates and running from a clone
Kandle is listed in the MCP Registry as io.github.Kernel-Hunter/kandle, so clients that browse the registry can find it.
npx runs kandle-mcp from a GitHub release. When a new version of Kandle comes out, change the version in the URL; getbridgestatus tells your agent when the app is newer than its server.
To run it from a clone instead, use pnpm install && pnpm build and point your agent at node /path/to/kandle/packages/mcp/bin/kandle-mcp.js.
All 26 tools
| Tool | What it does |