# Kandle

> Kandle is an open-source MCP server for finance and payments. Read and draw on a live crypto, stock or forex chart in your browser from an AI agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, self-hosted, CLI
- **Website:** https://kernel-hunter.github.io/kandle/
- **Repository:** https://github.com/kernel-hunter/kandle
- **MCP Registry name:** io.github.Kernel-Hunter/kandle
- **Categories:** finance and payments, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/kandle
