Skip to content
MCP server

Arkanva

MCP server for creating and editing Arkanva architecture diagrams and flowcharts from AI

Runs locally
Install
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.3.0
Listing updated
today

Similar MCP servers

About Arkanva

Arkanva is an MCP server for developer tools. It runs locally on your machine and is started by your AI client.

The README says this server lets MCP clients such as Claude Code, Claude Desktop, Cursor, Windsurf and Codex work directly with diagrams in an Arkanva workspace. A client can open, create, edit, import and export architecture diagrams and flowcharts, using tokens scoped to a single agent account.

Edits are applied in batches of up to 200 operations that either all succeed or all fail, checked against the diagram revision. Deletions, large edits and public sharing return a confirmation request that the user must approve before anything changes. Symbol search covers AWS, Azure, Google Cloud, Alibaba Cloud and generic catalogues.

The server suits engineers and architects who already work inside an AI coding assistant and want diagrams updated alongside their code. Use of the tools requires an Arkanva account on a plan that includes agent access.

Install

Run in a terminal

claude mcp add arkanva --env ARKANVA_API_KEY='<ARKANVA_API_KEY>' -- npx -y @arkanva/mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "arkanva": {
      "command": "npx",
      "args": [
        "-y",
        "@arkanva/mcp"
      ],
      "env": {
        "ARKANVA_API_KEY": "<ARKANVA_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "arkanva": {
      "command": "npx",
      "args": [
        "-y",
        "@arkanva/mcp"
      ],
      "env": {
        "ARKANVA_API_KEY": "<ARKANVA_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "arkanva": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@arkanva/mcp"
      ],
      "env": {
        "ARKANVA_API_KEY": "<ARKANVA_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "arkanva": {
      "command": "npx",
      "args": [
        "-y",
        "@arkanva/mcp"
      ],
      "env": {
        "ARKANVA_API_KEY": "<ARKANVA_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "arkanva": {
      "command": "npx",
      "args": [
        "-y",
        "@arkanva/mcp"
      ],
      "env": {
        "ARKANVA_API_KEY": "<ARKANVA_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • ARKANVA_API_KEYArkanva agent token (akf_...). Create one at https://arkanva.com/app under Account > Agent access.Required
  • ARKANVA_API_URLArkanva address. Change it only for a self-hosted server.

Tools this server provides (20)

Taken from the project documentation; the running server may differ.

arkanva_describe
API version, token scopes, plan features and limits
arkanva_list_documents
List diagrams, optionally in one folder
arkanva_open_document
Full diagram content and revision
arkanva_get_element
One node or edge
arkanva_create_document
Create an empty diagram
arkanva_update_document
Rename a diagram or move it between folders
arkanva_apply_operations
Add, update, remove and reorder nodes and edges, with optional layout
arkanva_delete_document
Delete a diagram (asks for confirmation)
arkanva_search_symbols
Search cloud, infrastructure, UML, flowchart and other symbols
arkanva_list_style_tokens
Pastel colour and style tokens for nodes and edges
arkanva_list_folders
List folders
arkanva_create_folder
Create a folder
arkanva_update_folder
Rename a folder
arkanva_delete_folder
Delete a folder, keeping or deleting its diagrams (asks first)
arkanva_import_document
New diagram from Mermaid, draw.io, Excalidraw or .arkanva.json
arkanva_export_document
SVG, PNG, animated GIF, Mermaid, draw.io or .arkanva.json
arkanva_list_templates
Official templates
arkanva_create_from_template
New diagram from a template
arkanva_sanitize_document
Find and mask IPs, hosts, emails, keys and ARNs
arkanva_manage_share
Public read-only link status, enable (asks first), disable, refresh

What it does

Diagram create and edit
Creates diagrams and applies batched node and edge changes with optional auto-layout.
Cloud symbol search
Finds icons across AWS, Azure, Google Cloud, Alibaba Cloud and generic symbol sets.
Mermaid, draw.io and Excalidraw import
Builds new diagrams from existing Mermaid, draw.io or Excalidraw files.
Multi-format export
Exports diagrams as SVG, PNG, animated GIF, Mermaid, draw.io or JSON.
Sensitive data masking
Detects and masks IP addresses, hostnames, emails, keys and ARNs before sharing.
Confirmation before destructive actions
Deletions, large edits and public share links wait for user approval.

Good for

  • Generating an AWS architecture diagram from a description inside an AI coding assistant
  • Converting an existing Mermaid flowchart into an editable Arkanva diagram
  • Exporting a diagram as PNG or SVG for documentation
  • Checking a network diagram for IP addresses or secrets before sharing it

Arkanva FAQ

How do I authenticate the server?

Set the ARKANVA_API_KEY environment variable to an agent token starting with akf_, created under Account > Agent access in the Arkanva app.

Does it work with self-hosted Arkanva?

Yes. The ARKANVA_API_URL variable can be changed for a self-hosted server, and it must use https except for localhost.

Which AI clients are supported?

The README names Claude Code, Claude Desktop, Cursor, Windsurf, VS Code and Codex, and says any other MCP client can connect.

What does the server need to run?

Node.js 20 or newer and an Arkanva account on a plan that includes agent access.

How do I add Arkanva to Claude Code?

Run this command in your terminal: claude mcp add arkanva --env ARKANVA_API_KEY='<ARKANVA_API_KEY>' -- npx -y @arkanva/mcp

What are the best alternatives to Arkanva?

The closest alternatives to Arkanva are Markasso, Arc, CloudSketch AI, Archboard and Chalk.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers