# TradeCanvas

> TradeCanvas is an open-source MCP server for developer tools. Look up and validate TradeCanvas chart indicators, options and drawing tools. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Windows, macOS, Linux
- **Website:** https://tradecanvas.dev
- **Repository:** https://github.com/bonguynvan/tradecanvas/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.bonguynvan/tradecanvas
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

Coding agents often guess option names for a charting library and get them wrong. This server answers from a catalog generated out of the TradeCanvas library's own code, so names, types and allowed values match the installed version. All tools are read-only and the README says none touches the network or your files.

The most distinctive tool is validate_options. Give it a target such as ChartWidget and an options object, and it flags unknown names with the likely intended one, values outside the allowed set, numbers passed as strings, bad intervals and feature switches, and warns when a language such as Japanese needs its locale registered first. Other tools list indicators with their default params and line keys, drawing tools and the points they need, finance charts like depth and equity curves, widget features and style keys.

It runs over stdio through npx and needs Node 20.19 or later. The library itself is MIT licensed, and an optional agent skill teaches the wider API.

## Features

- **Indicator catalog:** List indicators and read one in full, including default params, line keys and sample code.
- **Drawing tool lookup:** Find the type value and required points for each drawing tool.
- **Options validation:** Catch unknown option names, bad values and mistyped numbers before use.
- **Finance chart list:** See non-trading charts such as bars, donut, depth and gauge by class name.
- **Style and feature keys:** List widget feature switches and the style keys accepted by overrides.
- **Version-matched answers:** The catalog is generated from the library's code, so it follows the same release.

## Good for

- Stop an agent inventing option names for ChartWidget
- Check an options object before running it
- Find the right key for an indicator's output line
- Pick a drawing tool and see how many points it needs
- Add the server to Claude Code, Cursor or Codex with one command

## Install

### Claude Code (Terminal)

```sh
claude mcp add tradecanvas -- npx -y @tradecanvas/mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "tradecanvas": {
      "command": "npx",
      "args": [
        "-y",
        "@tradecanvas/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tradecanvas": {
      "command": "npx",
      "args": [
        "-y",
        "@tradecanvas/mcp"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "tradecanvas": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@tradecanvas/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tradecanvas": {
      "command": "npx",
      "args": [
        "-y",
        "@tradecanvas/mcp"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "tradecanvas": {
      "command": "npx",
      "args": [
        "-y",
        "@tradecanvas/mcp"
      ]
    }
  }
}
```

## Tools

- `list_indicators`: Built-in indicators with id, name and whether they draw over price or in a pane
- `get_indicator`: One indicator in full: params, inputs, line keys, levels and sample code
- `list_drawing_tools`: Drawing tools, their type values, points and options
- `list_finance_charts`: Non-trading charts such as bars, donut, depth, equity curve, market map and gauge
- `list_options`: Options of ChartWidget, Chart, ChartWidgetGrid or a finance chart
- `list_widget_features`: Names accepted by ChartWidget's features switch
- `list_style_keys`: Style keys and values for overrides
- `validate_options`: Check an options object before use

## FAQ

### What does it need to run?

Node 20.19 or later; it starts over stdio with npx -y @tradecanvas/mcp.

### Does it access my files or the network?

The README says all tools are read-only and none touches the network or your files.

### What licence applies?

The README states MIT.

### Does it work on Windows?

Yes, with a cmd /c wrapper around npx outside WSL, as the README shows.

### Is TradeCanvas free?

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

### How do I add TradeCanvas to Claude Code?

Run this command in your terminal: claude mcp add tradecanvas -- npx -y @tradecanvas/mcp

### What are the best alternatives to TradeCanvas?

The closest alternatives to TradeCanvas are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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