Arkanva MCP server
Arkanva's symbol catalogue includes Alibaba Cloud icons, so agents can search for and place Alibaba Cloud architecture symbols when drawing or editing diagrams.
Import existing Excalidraw scenes into Arkanva as new diagrams, letting agents convert hand-drawn whiteboard sketches into editable Arkanva documents.
Symbol search spans the Google Cloud icon catalogue, allowing agents to find and place Google Cloud infrastructure symbols in architecture diagrams.
Create Arkanva diagrams from Mermaid flowchart/graph definitions and export Arkanva diagrams back out as Mermaid source for use in docs and repositories.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Arkanva MCP server
The official Model Context Protocol server for Arkanva, the hand-drawn 3D pastel diagramming workspace. It lets Claude Code, Claude Desktop, Cursor, Windsurf, Codex and any other MCP client create, read, edit, import, export and share Arkanva architecture diagrams, flowcharts and system designs in your workspace.
20 tools: diagrams, folders, edits with auto-layout, symbol search across AWS, Azure, Google Cloud, Alibaba Cloud and generic catalogues, templates, Mermaid / draw.io / Excalidraw import, SVG / PNG / GIF / Mermaid / draw.io export, sensitive-data masking and share links.
Atomic edits: every batch of up to 200 operations applies completely or not at all, checked against the diagram revision.
Human in the loop: deletions, large edits and public sharing come back as
confirmation_requiredand only apply after you approve them.A single self-contained file with no runtime dependencies. It talks to Arkanva over HTTPS with your agent token and writes nothing but MCP frames to stdout.
Requirements
Node.js 20 or newer.
An Arkanva account on a plan that includes agent access.
An agent token (
akf_…): open arkanva.com/app, then Account → Agent access → Create token. The token is shown once; copy it.
Related MCP server: excalidraw-mcp
Install
You do not install anything by hand: your MCP client runs npx -y @arkanva/mcp, which downloads
and starts the latest release. To pin it globally instead, run npm install -g @arkanva/mcp and
use arkanva-mcp as the command.
Claude Code
claude mcp add -s user arkanva --env ARKANVA_API_KEY=akf_your_token -- npx -y @arkanva/mcp-s user makes the server available in every project. Check it with claude mcp list.
Claude Desktop
Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows:
%APPDATA%\Claude\) and restart the app:
{
"mcpServers": {
"arkanva": {
"command": "npx",
"args": ["-y", "@arkanva/mcp"],
"env": { "ARKANVA_API_KEY": "akf_your_token" }
}
}
}If Claude Desktop on Windows cannot start npx, use "command": "cmd" with
"args": ["/c", "npx", "-y", "@arkanva/mcp"].
Cursor
Add the same mcpServers block to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one
project; keep the token out of version control).
Windsurf
Add the same mcpServers block to ~/.codeium/windsurf/mcp_config.json, then refresh the MCP
servers in Windsurf settings.
VS Code
.vscode/mcp.json:
{
"servers": {
"arkanva": {
"type": "stdio",
"command": "npx",
"args": ["-y", "@arkanva/mcp"],
"env": { "ARKANVA_API_KEY": "akf_your_token" }
}
}
}Codex
~/.codex/config.toml:
[mcp_servers.arkanva]
command = "npx"
args = ["-y", "@arkanva/mcp"]
env = { ARKANVA_API_KEY = "akf_your_token" }Configuration
Variable | Required | Default | Purpose |
| yes | Agent token ( | |
| no |
| Arkanva address, for self-hosted servers. Must be https, except |
| no | auto-detected | Chrome, Chromium or Edge used to render PNG and GIF exports. |
npx -y @arkanva/mcp --help
npx -y @arkanva/mcp --versionThe token sits in your client configuration in plain text. Keep that file private, never commit
it, and revoke the token under Account → Agent access if it leaks. Tokens expire; when one does,
tools answer with a 401 error that tells you to create a new one.
Tools
Tool | What it does | Access |
| API version, token scopes, plan features and limits | read-only |
| List diagrams, optionally in one folder | read-only |
| Full diagram content and revision | read-only |
| One node or edge | read-only |
| Create an empty diagram | additive |
| Rename a diagram or move it between folders | additive |
| Add, update, remove and reorder nodes and edges, with optional layout | destructive |
| Delete a diagram (asks for confirmation) | destructive |
| Search cloud, infrastructure, UML, flowchart and other symbols | read-only |
| Pastel colour and style tokens for nodes and edges | read-only |
| List folders | read-only |
| Create a folder | additive |
| Rename a folder | additive |
| Delete a folder, keeping or deleting its diagrams (asks first) | destructive |
| New diagram from Mermaid, draw.io, Excalidraw or | additive |
| SVG, PNG, animated GIF, Mermaid, draw.io or | additive |
| Official templates | read-only |
| New diagram from a template | additive |
| Find and mask IPs, hosts, emails, keys and ARNs | destructive |
| Public read-only link status, enable (asks first), disable, refresh | additive |
Every input is validated against its JSON schema before any request is sent. Full parameter reference: arkanva.com/docs.
Example prompts
"Draw the architecture of a serverless checkout on AWS in Arkanva: API Gateway, Lambda, DynamoDB and SQS, laid out left to right."
"Open my Payments diagram and add a Redis cache between the API and Postgres."
"Import this Mermaid flowchart into Arkanva in the Onboarding folder."
"Export the Platform overview diagram as a PNG at 2x to ./platform.png."
"Check the Network diagram for IP addresses and secrets and show me what would be masked."
Errors
Failures come back as MCP tool errors (isError: true) with the HTTP status, an error code and
a hint. The common ones:
Code | Meaning |
| Token wrong, expired or revoked: create a new one |
| Token lacks the scope, e.g. |
| The feature is not in the account plan |
| Plan limit reached; the error includes |
| Too many calls; wait a minute |
| The diagram changed; open it again and rebuild the batch |
| Ask the user, then repeat the call with the returned |
Startup problems (missing token, bad URL) are printed to stderr and the process exits with code 1, which MCP clients show in their server log.
License
MIT for this package. The bundled open-source packages and the Nunito font keep their own
licenses, listed in dist/third-party-notices.txt.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Immutable agent diagrams: create, edit, validate and render versioned diagrams over MCP.
Create, edit and organize hand-drawn diagrams (flowcharts, ER, architecture) from any AI agent.
Create, read and edit architecture, flow and ER diagrams on a live canvas shared with your team.
Collaborative whiteboard MCP server — create objects, connectors, C4 diagrams, and manage boards
Related MCP Servers
- AlicenseAqualityDmaintenanceGenerates Excalidraw architecture diagrams with support for 60+ components including GCP, Kafka, and AI/Agentic shapes. Provides MCP tools for creating, modifying, and converting diagrams from structured input or Mermaid syntax.41MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for creating and managing Excalidraw diagrams, supporting elements, libraries, icons, import/export, and auto-layout flowcharts.3,392 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables planning and maintaining system architecture as typed, linted, live diagrams stored as files in the repo, with MCP tools for cataloging, creating, editing, linting, exporting, and viewing diagrams locally.8MIT
- FlicenseNot gradedqualityCmaintenanceEnables MCP clients to create and live-update Excalidraw diagrams in batches, with preview links, checkpoint restoration, browser editing, and optional authenticated shared storage.-