# Vgraph MCP

> Vgraph MCP is an open-source MCP server for design and media. Draws concept maps, IBIS, causal loop diagrams and timelines as images from text. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, CLI, vscode
- **Website:** https://vithanco.com
- **Repository:** https://github.com/vithanco/vgraph
- **MCP Registry name:** com.vithanco/vgraph-mcp
- **Categories:** design and media, productivity
- **Listing updated:** 2026-11-16

## About

Vgraph turns a short text description in VGL, the Vithanco Graph Language, into a laid-out diagram, so an agent writes nodes and edges and the engine handles placement. Each notation carries its own rules about which links are valid, and for causal loop diagrams it works out whether each closed loop is reinforcing or balancing.

The notations shipped with the open-source engine include IBIS, Concept Map, Current Reality Tree, Evaporating Cloud, Future Reality Tree, Prerequisite and Transition Trees, Goal Tree, Impact Mapping, Benefit Breakdown Structure, C4, Attack-Defense Tree, Decision Tree, Timeline and Arithmetic. A document can also declare notations of its own.

The Swift engine is compiled to WebAssembly, so the MCP server can run locally with npx over stdio or be reached at a hosted Streamable HTTP endpoint. The same engine also powers a browser editor, an Obsidian plugin and a VS Code extension.

## Features

- **Typed diagrams:** Nodes and edges have meanings that the notation checks.
- **Loop analysis:** Marks closed feedback loops as reinforcing or balancing.
- **Many notations:** Covers IBIS, C4, Theory of Constraints trees, timelines and more.
- **Text in, layout out:** Describe nodes and links in VGL and the engine places them.
- **Local or hosted:** Runs via WebAssembly with npx, or at a hosted HTTP endpoint.
- **Custom notations:** Documents can define their own notation in VGL.

## Good for

- Map a design question as IBIS questions, answers, pros and cons
- Show feedback loops behind a project that keeps slipping
- Sketch a C4 software architecture at several zoom levels
- Trace symptoms to a root cause with a Current Reality Tree

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http vgraph-mcp https://mcp.vithanco.com/mcp
```

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

```sh
https://mcp.vithanco.com/mcp
```

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

```json
{
  "mcpServers": {
    "vgraph-mcp": {
      "url": "https://mcp.vithanco.com/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "vgraph-mcp": {
      "type": "http",
      "url": "https://mcp.vithanco.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "vgraph-mcp": {
      "serverUrl": "https://mcp.vithanco.com/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "vgraph-mcp": {
      "type": "http",
      "url": "https://mcp.vithanco.com/mcp"
    }
  }
}
```

## FAQ

### How do I run it?

Locally with npx @vithanco/vgraph-mcp over stdio, or use the hosted endpoint at mcp.vithanco.com.

### What format are diagrams written in?

VGL, a small text format that the README says diffs like code.

### Does the web editor upload my diagrams?

The site says nothing you type leaves your browser.

### What does the engine output?

It lays out the graph and draws it as SVG.

### Is Vgraph MCP free?

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

### How do I add Vgraph MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http vgraph-mcp https://mcp.vithanco.com/mcp

### What are the best alternatives to Vgraph MCP?

The closest alternatives to Vgraph MCP are HyperFrames by HeyGen, Ha MCP, ffmpeg-skill, Concord MCP and note1.

## Alternatives

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.

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