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/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.vithanco.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"vgraph-mcp": {
"url": "https://mcp.vithanco.com/mcp"
}
}
}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

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media