ArchScript
Let Claude edit and review architecture diagrams live in ArchScript for Mac
- 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.mcpbAdd 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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory