Skip to content
MCP server

ArchScript

Let Claude edit and review architecture diagrams live in ArchScript for Mac

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
macOS, Web
Runs
Locally
Version
1.0.0
Listing updated
3 days ago

About ArchScript

ArchScript is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.

ArchScript describes a system as code, covering domains, services, databases, queues and deployments from cluster to server to Docker container, and draws the diagram from it. The MCP server comes with the Mac app, listens only on 127.0.0.1 behind an access token, and lets Claude read the open models, validate them, get a review score with rule findings, and view the rendered diagram as an image.

Claude does not rewrite the file. It sends small structured operations, such as add_container, add_element or add_relation, which the app turns into minimal text edits so comments and formatting survive. Each change shows up live as a single undoable edit, and the assistant gets validation feedback back after every step. Exports include Mermaid, PlantUML, Markdown, JSON and Terraform.

Setup needs ArchScript for Mac (macOS 14 or later) with ArchScript Pro, which has a 14-day trial. The repository holds docs, examples and an open-source stdio bridge, while the app itself is closed source. A free browser Playground exists without AI access.

Install

Run in a terminal

claude mcp add archscript-mcp --env ARCHSCRIPT_TOKEN='<ARCHSCRIPT_TOKEN>' -- npx -y https://github.com/schlummer13/archscript-mcp/releases/download/v1.0.0/archscript.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "archscript-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/schlummer13/archscript-mcp/releases/download/v1.0.0/archscript.mcpb"
      ],
      "env": {
        "ARCHSCRIPT_TOKEN": "<ARCHSCRIPT_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "archscript-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/schlummer13/archscript-mcp/releases/download/v1.0.0/archscript.mcpb"
      ],
      "env": {
        "ARCHSCRIPT_TOKEN": "<ARCHSCRIPT_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "archscript-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/schlummer13/archscript-mcp/releases/download/v1.0.0/archscript.mcpb"
      ],
      "env": {
        "ARCHSCRIPT_TOKEN": "<ARCHSCRIPT_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "archscript-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/schlummer13/archscript-mcp/releases/download/v1.0.0/archscript.mcpb"
      ],
      "env": {
        "ARCHSCRIPT_TOKEN": "<ARCHSCRIPT_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "archscript-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/schlummer13/archscript-mcp/releases/download/v1.0.0/archscript.mcpb"
      ],
      "env": {
        "ARCHSCRIPT_TOKEN": "<ARCHSCRIPT_TOKEN>"
      }
    }
  }
}

Configuration

  • ARCHSCRIPT_TOKENAccess token from ArchScript → Settings → AIRequired

Tools this server provides (10)

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

archscript_guide
Teaches the language, element types and rules.
list_documents
Lists open documents.
get_document
Reads a document with line numbers and structure.
create_document
Creates a new architecture from source.
set_document_source
Replaces a document's source in one undoable step.
edit_document
Applies structured edits such as add_element, add_container and add_relation.
validate
Returns diagnostics.
review
Returns review score, grade and rule findings.
render_diagram
Returns the diagram as an image.
export
Exports Mermaid, PlantUML, Markdown, JSON or Terraform.

What it does

Live diagram edits
Changes appear in the window as one undoable edit.
Structured operations
Adds containers, elements and relations without rewriting the file.
Validate and review
Returns diagnostics, a score and rule findings.
Rendered image
The assistant can look at the diagram.
Multi-format export
Mermaid, PlantUML, Markdown, JSON or Terraform.
Local-only server
Listens on 127.0.0.1 with an access token.

Good for

  • Add a cache or worker to an existing architecture by describing it
  • Ask which architecture rules a model breaks
  • Draft an event-driven design from a short brief
  • Export a model as Terraform for AWS

Pricing

Freemium, from $9.99 a month

Mac app and browser Playground free; ArchScript Pro $9.99/mo or $89.99/yr

Prices change. Check archscript.dev before you buy.

ArchScript FAQ

What do I need?

ArchScript for Mac on macOS 14 or later with ArchScript Pro, and an access token from Settings -> AI.

Does my data leave the Mac?

The site says nothing leaves your Mac through ArchScript.

How much is Pro?

$9.99 a month or $89.99 a year, with 14 days free.

Which clients connect?

Claude Desktop via an .mcpb bundle and Claude Code over HTTP.

Is ArchScript free?

ArchScript has a free plan, with paid plans for more usage or features. Paid plans start at $9.99 a month.

How do I add ArchScript to Claude Code?

Run this command in your terminal: claude mcp add archscript-mcp --env ARCHSCRIPT_TOKEN='<ARCHSCRIPT_TOKEN>' -- npx -y https://github.com/schlummer13/archscript-mcp/releases/download/v1.0.0/archscript.mcpb

What are the best alternatives to ArchScript?

The closest alternatives to ArchScript are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

Alternatives to ArchScript

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory