# Semiotic

> Semiotic is an open-source MCP server for design and media. Select, validate, repair, render and inspect React charts through MCP. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI
- **Website:** https://semiotic.nteract.io
- **Repository:** https://github.com/nteract/semiotic
- **MCP Registry name:** io.github.nteract/semiotic
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-14

## About

Semiotic is a React data-visualization library with an MCP server that lets a coding assistant produce charts and check them instead of guessing at props. The registry entry describes a loop of choosing a chart, validating its configuration, repairing it, rendering it and inspecting the result.

The library covers standard charts (line, bar, scatter, area) driven by accessors such as `xAccessor` and `categoryAccessor`, plus network diagrams, geo maps and streaming visualizations. `LinkedCharts` coordinates charts through a shared selection, so hovering one highlights matching data in another. The README says structured schemas, diagnostics and rendering evidence are there to help coding assistants implement, check and repair chart configurations, and it publishes task walkthroughs such as checking category totals or correcting a published chart.

It needs React 18.1+ or React 19 and installs with `npm install semiotic`. The MCP server runs over stdio from the npm package or at a hosted streamable-HTTP endpoint.

## Features

- **Chart validation:** Checks a chart configuration and reports diagnostics.
- **Repair and render:** Fixes configurations and renders charts so output can be inspected.
- **Accessor-based API:** Line, bar, scatter and area charts share one data-field API.
- **Linked views:** `LinkedCharts` coordinates hover and selection across charts.
- **Streaming and networks:** Supports network graphs, geo maps and streaming data.

## Good for

- Have an assistant pick and build a chart for a dataset
- Validate a chart config before shipping it
- Repair a chart that renders wrongly
- Build a dashboard whose charts highlight together

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http semiotic https://semiotic-mcp-server-481507046413.us-west1.run.app/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://semiotic-mcp-server-481507046413.us-west1.run.app/mcp
```

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

```json
{
  "mcpServers": {
    "semiotic": {
      "url": "https://semiotic-mcp-server-481507046413.us-west1.run.app/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "semiotic": {
      "type": "http",
      "url": "https://semiotic-mcp-server-481507046413.us-west1.run.app/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "semiotic": {
      "serverUrl": "https://semiotic-mcp-server-481507046413.us-west1.run.app/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "semiotic": {
      "type": "http",
      "url": "https://semiotic-mcp-server-481507046413.us-west1.run.app/mcp"
    }
  }
}
```

## FAQ

### What does it need?

React 18.1 or newer, or React 19; install with `npm install semiotic`.

### Does the MCP server run locally?

It can run over stdio from the npm package, and a hosted streamable-HTTP endpoint is also listed.

### Do line charts accept categories?

`LineChart` needs numeric x values; for named categories the README says to use `BarChart` with `categoryAccessor`.

### Is Semiotic free?

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

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

Run this command in your terminal: claude mcp add --transport http semiotic https://semiotic-mcp-server-481507046413.us-west1.run.app/mcp

### What are the best alternatives to Semiotic?

The closest alternatives to Semiotic are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

## 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.
- [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.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.

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