Skip to content
MCP server

Vgraph MCP

Draws concept maps, IBIS, causal loop diagrams and timelines as images from text

Pricing
Open source
Platforms
Web, CLI, vscode
Runs
Locally or Remotely
Version
1.0.9
Listing updated
1 day ago

About Vgraph MCP

Vgraph MCP is an open-source MCP server for design and media. It can run locally on your machine or as a hosted remote server.

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.

Install

Run in a terminal

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

Add to Settings → Connectors → Add custom connector

https://mcp.vithanco.com/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "vgraph-mcp": {
      "url": "https://mcp.vithanco.com/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

What it does

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

Pricing

Open source

Free in the browser; engine is open source

Prices change. Check vithanco.com before you buy.

Vgraph 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 to Vgraph MCP

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  3. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  4. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  5. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity