# WestCoast Charts

> WestCoast Charts is an MCP server for design and media. Validate, render and describe WestCoast Charts specs headlessly from an agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, API
- **Website:** https://westcoast-charts.com/agents/
- **Repository:** https://github.com/lokumbus/west-coast-charts-agent
- **MCP Registry name:** io.github.Lokumbus/west-coast-charts-agent
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-18

## About

The point is a feedback loop for charts an agent writes. It validates a chart configuration and returns the exact path, issue and suggested fix for an option error, renders SVG or PNG, and describes what was actually drawn, including values, scales and supported aggregates, along with a data table.

The package provides a wcc command line tool, the wcc-mcp server and a headless render API. It needs Node.js 20 or newer and the WestCoast Charts library from version 1.1.5 up to below 1.2.0, which it now installs as a regular dependency. Premium chart types need a separately supplied complete library and a licence key; an evaluation mode renders watermarked previews.

Settings include a default light or dark theme and an upper limit on PNG pixels. It starts over stdio with npx -y west-coast-charts-agent.

## Features

- **Option validation:** Reports the exact path, issue and suggested fix for chart option errors.
- **SVG and PNG rendering:** Renders charts headlessly with a configurable pixel cap.
- **Drawn-state description:** Describes the rendered chart with values, scales and aggregates.
- **Data table:** Returns a data table alongside the description.
- **CLI and API:** The same package offers a wcc CLI and a render API.
- **Premium evaluation:** A watermarked preview mode for Premium types without a key.

## Good for

- Let an agent self-check a chart configuration
- Generate chart images in a build pipeline
- Confirm rendered values match the data
- Catch a misspelled option before shipping

## Install

### Claude Code (Terminal)

```sh
claude mcp add west-coast-charts-agent --env WCC_LICENSE_KEY='<WCC_LICENSE_KEY>' -- npx -y west-coast-charts-agent
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "west-coast-charts-agent": {
      "command": "npx",
      "args": [
        "-y",
        "west-coast-charts-agent"
      ],
      "env": {
        "WCC_LICENSE_KEY": "<WCC_LICENSE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "west-coast-charts-agent": {
      "command": "npx",
      "args": [
        "-y",
        "west-coast-charts-agent"
      ],
      "env": {
        "WCC_LICENSE_KEY": "<WCC_LICENSE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "west-coast-charts-agent": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "west-coast-charts-agent"
      ],
      "env": {
        "WCC_LICENSE_KEY": "<WCC_LICENSE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "west-coast-charts-agent": {
      "command": "npx",
      "args": [
        "-y",
        "west-coast-charts-agent"
      ],
      "env": {
        "WCC_LICENSE_KEY": "<WCC_LICENSE_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "west-coast-charts-agent": {
      "command": "npx",
      "args": [
        "-y",
        "west-coast-charts-agent"
      ],
      "env": {
        "WCC_LICENSE_KEY": "<WCC_LICENSE_KEY>"
      }
    }
  }
}
```

## FAQ

### Which Node version is needed?

Node.js 20 or newer.

### Which library versions match?

West Coast Charts 1.1.5 up to below 1.2.0 with agent tools 0.2.4.

### Are Premium chart types included?

No. They need the separately supplied library and a licence key.

### How do I start it?

Run npx -y west-coast-charts-agent.

### How do I add WestCoast Charts to Claude Code?

Run this command in your terminal: claude mcp add west-coast-charts-agent --env WCC_LICENSE_KEY='<WCC_LICENSE_KEY>' -- npx -y west-coast-charts-agent

### What are the best alternatives to WestCoast Charts?

The closest alternatives to WestCoast Charts are REA, HyperFrames by HeyGen, Context7, Chrome DevTools MCP and Codebase Memory.

## Where this comes from

- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [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.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/westcoast-charts
