# Arkanva

> Arkanva is an MCP server for developer tools. MCP server for creating and editing Arkanva architecture diagrams and flowcharts from AI. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, macOS, Windows, Linux, vscode, Web, self-hosted
- **Website:** https://arkanva.com/docs
- **Repository:** https://github.com/akarkode/arkanva-mcp
- **MCP Registry name:** io.github.akarkode/arkanva
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-19

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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.

## Alternatives

- [Markasso](https://ai-powered.com/mcp/markasso): Markasso is an open-source MCP server for developer tools.
- [Arc](https://ai-powered.com/mcp/arc): Arc is a free MCP server for design and media.
- [CloudSketch AI](https://ai-powered.com/mcp/cloudsketch-ai): CloudSketch AI is a freemium MCP server for developer tools.
- [Archboard](https://ai-powered.com/mcp/archboard): Archboard is a freemium MCP server for design and media.
- [Chalk](https://ai-powered.com/mcp/chalk): Chalk is an MCP server for developer tools.
- [SchemaSketch](https://ai-powered.com/mcp/schemasketch): SchemaSketch is a free MCP server for databases.
- [ArcSync](https://ai-powered.com/mcp/arcsync): ArcSync is a freemium MCP server for cloud and infrastructure.
- [Network Sketcher (Local MCP)](https://ai-powered.com/mcp/network-sketcher-local-mcp): Network Sketcher (Local MCP) is an open-source MCP server for design and media.

---
Source: https://ai-powered.com/mcp/arkanva
