# Markasso

This MCP server for Claude Code creates and edits Markasso diagrams. An agent can also join a shared board and work on it live.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7 repo stars
- Author: AlbertoBarrago
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AlbertoBarrago/markasso/tree/HEAD/mcp
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/markasso

## What it does

Markasso gives an agent tools to create, inspect, and change diagrams. It can add nodes and connections, edit labels and layout, search for architecture icons, and save work as `.markasso` or export it as SVG or PNG. The server reports overlaps and crossings that affect diagram readability.

For shared work, the agent joins an active Markasso session. Participants see its edits, and it can read changes made on the board. Live sessions require a Markasso Cloud licence and the `MARKASSO_LICENSE` variable; other operations do not require that licence. Node 22+ is required. Set `MARKASSO_URL` to connect to another Markasso instance.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `MARKASSO_LICENSE`, `MARKASSO_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env MARKASSO_LICENSE=<MARKASSO_LICENSE> --env MARKASSO_URL=<MARKASSO_URL> --transport stdio mcp -- npx -y @markasso/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp --env MARKASSO_LICENSE=<MARKASSO_LICENSE> --env MARKASSO_URL=<MARKASSO_URL> -- npx -y @markasso/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@markasso/mcp"
            ],
            "env": {
                "MARKASSO_LICENSE": "<MARKASSO_LICENSE>",
                "MARKASSO_URL": "<MARKASSO_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@markasso/mcp"
            ],
            "env": {
                "MARKASSO_LICENSE": "<MARKASSO_LICENSE>",
                "MARKASSO_URL": "<MARKASSO_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e MARKASSO_LICENSE=<MARKASSO_LICENSE> -e MARKASSO_URL=<MARKASSO_URL> mcp npx -y @markasso/mcp
```
Replace <…> with your own values

## When to use it
- build an architecture diagram from nodes and connections
- inspect a diagram and spot layout problems
- arrange a diagram from left to right or top to bottom
- export a diagram as SVG or PNG
- edit a shared Markasso board

## Example prompts
- Create a service architecture diagram with an API, database, and queue.
- Read the diagram and arrange it from left to right.
- Join the active Markasso session and add the missing database node to the board.

## Similar
- [Context7](https://affpapa.org/en/nevibecode/mcp/context7.md) — MCP server · 5563 installs
- [Search Google Flights](https://affpapa.org/en/nevibecode/mcp/search-google-flights.md) — MCP server · 2595 installs
- [Math-MCP](https://affpapa.org/en/nevibecode/mcp/math-mcp.md) — MCP server · 5958 installs
- [pipeworx gateway](https://affpapa.org/en/nevibecode/mcp/pipeworx-gateway.md) — MCP server · 419019 installs
- [SparkForge](https://affpapa.org/en/nevibecode/mcp/sparkforge.md) — MCP server · 219896 installs
- [OpenWebSearch](https://affpapa.org/en/nevibecode/mcp/openwebsearch.md) — MCP server · 494 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
