Skip to content
MCP server

Kandle

Read and draw on a live crypto, stock or forex chart in your browser from an AI agent

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
Web, self-hosted, CLI
Runs
Locally
Version
0.11.0
Listing updated
3 days ago

About Kandle

Kandle is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

Kandle is a free, open-source charting app that runs in the browser and has no server of its own: market data goes from each provider straight to your browser, and charts, scripts and API keys stay in local storage. The MCP server, kandle-mcp, lets Claude Code, Codex, Cursor or Gemini CLI act on the chart while you watch, for example marking the last swing high and low and drawing a Fibonacci retracement between them.

The agent starts the server, then the Kandle tab connects to it over a WebSocket on 127.0.0.1. You ask the agent for a pairing code through get_bridge_status, paste it into the Agent panel and switch on Agent bridge; the code is remembered after the first pairing. It needs Node.js 22.12 or newer, and works with the hosted app or a copy you run yourself.

The README lists 28 tools, covering reading the chart's state (symbol, timeframe, indicators, drawings, alerts, replay and layout) plus drawing, indicators and running scripts, as the registry notes, and backtests. Live crypto data from five exchanges works without a key.

Install

Run in a terminal

claude mcp add kandle -- npx -y https://github.com/Kernel-Hunter/kandle/releases/download/v0.11.0/kandle-mcp-0.11.0.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "kandle": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Kernel-Hunter/kandle/releases/download/v0.11.0/kandle-mcp-0.11.0.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "kandle": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Kernel-Hunter/kandle/releases/download/v0.11.0/kandle-mcp-0.11.0.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "kandle": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Kernel-Hunter/kandle/releases/download/v0.11.0/kandle-mcp-0.11.0.mcpb"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "kandle": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Kernel-Hunter/kandle/releases/download/v0.11.0/kandle-mcp-0.11.0.mcpb"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "kandle": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/Kernel-Hunter/kandle/releases/download/v0.11.0/kandle-mcp-0.11.0.mcpb"
      ]
    }
  }
}

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

get_bridge_status
Returns connection state and the pairing code.
get_chart_state
Returns symbol, timeframe, last bar, indicators, drawings, alerts, replay and layout.

What it does

Browser-only charting
Data goes from providers to your browser; no account and no Kandle server.
Agent drawing
An agent can mark levels, add indicators and draw on the chart.
Scripts and backtests
Run scripts in the editor and test strategies.
Local pairing
The browser pairs with the server over a localhost WebSocket.
Key-free crypto data
Live crypto from five exchanges works without a key.
28 tools
The README lists 28 tools for chart state, drawing and scripts.

Good for

  • Mark support and resistance on a BTC chart
  • Add RSI and run an EMA cross script
  • Draw a Fibonacci retracement between swing points
  • Backtest a script on a chosen symbol
  • Read what indicators and alerts a chart currently has

Pricing

Open source

Free and open source; runs in the browser

Prices change. Check kernel-hunter.github.io before you buy.

Kandle FAQ

Does Kandle need an account?

No. It runs in the browser, and the README says it has no server of its own.

How do I pair the agent?

Ask the agent for the pairing code via get_bridge_status, then paste it in Kandle's Agent panel and turn on Agent bridge.

What does the server need?

Node.js 22.12 or newer.

Is it open source?

Yes. The site calls it free and open source.

Is Kandle free?

Yes. Kandle is open source, so you can use and self-host it for free.

How do I add Kandle to Claude Code?

Run this command in your terminal: claude mcp add kandle -- npx -y https://github.com/Kernel-Hunter/kandle/releases/download/v0.11.0/kandle-mcp-0.11.0.mcpb

What are the best alternatives to Kandle?

The closest alternatives to Kandle are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.

Alternatives to Kandle

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat

    • 8 tools
    • Remote
    • Freemium
    • 8.1K GitHub stars
    • Marketing and SEO
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments