Arkanva
MCP server for creating and editing Arkanva architecture diagrams and flowcharts from AI
- 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/mcpAdd 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.RequiredARKANVA_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.
