# sysketch

> sysketch is an open-source MCP server for design and media. Turn a short YAML description into a clean system design diagram as SVG or PNG. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, CLI, Web
- **Website:** https://sysketch.vercel.app
- **Repository:** https://github.com/tonys-coding/sysketch/tree/HEAD/packages/mcp
- **MCP Registry name:** io.github.Tonys-Coding/sysketch
- **Categories:** design and media, developer tools
- **Listing updated:** 2026-11-15

## About

Sysketch changes who draws the picture. The assistant writes a few lines describing the system, and the server renders a hand-sketched diagram, which the README measures at 4,352 output tokens against 77,518 when the assistant drew SVG itself on five requests. Tool definitions add about 450 tokens to a session.

Two tools exist. `render_diagram` takes a spec or a file, outputs `.svg` or `.png`, accepts a theme such as blueprint, and can return a preview to the assistant. `list_icons` shows recognised names and searches installed logos. Names like stripe or kafka show Simple Icons marks, and cloud services use official AWS, Azure and Google Cloud icons.

A hosted URL works as a Claude or ChatGPT connector with no sign-in, opening the diagram in chat; nothing is stored and each link contains its own description. The npm package runs locally and saves diagrams with their descriptions into your project so you can ask for changes later. MIT licensed.

## Features

- **Compact specs:** A short description replaces long hand-drawn SVG.
- **SVG or PNG output:** Diagrams save to a diagrams folder with their source description.
- **Themes:** Options such as a blueprint theme change the look.
- **Cloud and product icons:** AWS, Azure, Google Cloud and Simple Icons logos are recognised.
- **Hosted or local:** Use the remote URL in chat apps or the npm package in your project.

## Good for

- Sketch a ride-sharing architecture in chat
- Add a notification service to an existing diagram
- Produce diagrams for design docs inside a repo
- Share a diagram by link

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http sysketch https://sysketch.vercel.app/mcp
```

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

```sh
https://sysketch.vercel.app/mcp
```

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

```json
{
  "mcpServers": {
    "sysketch": {
      "url": "https://sysketch.vercel.app/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "sysketch": {
      "type": "http",
      "url": "https://sysketch.vercel.app/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "sysketch": {
      "serverUrl": "https://sysketch.vercel.app/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "sysketch": {
      "type": "http",
      "url": "https://sysketch.vercel.app/mcp"
    }
  }
}
```

## Tools

- `render_diagram`: Draw a diagram from a spec or file to SVG or PNG with an optional theme
- `list_icons`: List icons and recognized names; search installed logos

## FAQ

### Does it need sign-in?

No, the hosted connector uses no authentication.

### Is anything stored?

The site says nothing is stored; each link carries its own description.

### What does the local package need?

Node.js 20 or newer.

### What licence is it?

MIT.

### Is sysketch free?

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

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

Run this command in your terminal: claude mcp add --transport http sysketch https://sysketch.vercel.app/mcp

### What are the best alternatives to sysketch?

The closest alternatives to sysketch 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/sysketch
