Skip to content
MCP server

ArcSync

Architecture graphs parsed from your infrastructure code, for coding agents

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI
Runs
Locally
Version
0.3.20
Listing updated
3 days ago

About ArcSync

ArcSync is a freemium MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.

The server answers questions about infrastructure the agent has not been told about, because ArcSync has already parsed it from Terraform, CDK, CloudFormation, Pulumi, ARM or Serverless Framework code. A typical question is what a pull request changes in your infrastructure.

It has 11 tools, all read-only except start_parse, which parses a GitHub repository into a new diagram and uses one parse, and push_diagram, which saves a validated diagram the agent wrote. It cannot delete, comment, touch billing, or edit a diagram parsed from your code. Diagrams come back as Mermaid or JSON with a canvas link.

Setup is claude mcp add arcsync -- npx -y arcsync-mcp with Node 22+. You connect in the browser, or use an MCP credential for CI or shared machines.

Install

Run in a terminal

claude mcp add arcsync-mcp --env ARCSYNC_CLIENT_SECRET='<ARCSYNC_CLIENT_SECRET>' -- npx -y arcsync-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "arcsync-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "arcsync-mcp"
      ],
      "env": {
        "ARCSYNC_CLIENT_SECRET": "<ARCSYNC_CLIENT_SECRET>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "arcsync-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "arcsync-mcp"
      ],
      "env": {
        "ARCSYNC_CLIENT_SECRET": "<ARCSYNC_CLIENT_SECRET>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "arcsync-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "arcsync-mcp"
      ],
      "env": {
        "ARCSYNC_CLIENT_SECRET": "<ARCSYNC_CLIENT_SECRET>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "arcsync-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "arcsync-mcp"
      ],
      "env": {
        "ARCSYNC_CLIENT_SECRET": "<ARCSYNC_CLIENT_SECRET>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "arcsync-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "arcsync-mcp"
      ],
      "env": {
        "ARCSYNC_CLIENT_SECRET": "<ARCSYNC_CLIENT_SECRET>"
      }
    }
  }
}

Configuration

  • ARCSYNC_CLIENT_IDMCP credential client ID for CI or shared machines; omit to connect in the browser
  • ARCSYNC_CLIENT_SECRETMCP credential secret, paired with ARCSYNC_CLIENT_ID

Tools this server provides (11)

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

list_diagrams
Lists diagrams, optionally by repository, branch or path.
get_diagram
Returns a diagram as Mermaid or JSON with a canvas link.
describe_resource
Shows one resource's type, attributes and relationships.
get_delta
Shows what a pull request or re-parse changes.
list_versions
Lists a diagram's saved versions (Pro).
start_parse
Parses a GitHub repository into a new diagram.
get_parse_status
Shows progress of a parse.
validate_diagram
Checks an agent-written diagram and lists problems by line.
push_diagram
Saves a validated diagram and returns canvas and Notion embed links.
get_diagram_source
Returns a pushed diagram's source for editing.
list_icons
Lists icon ids a written diagram can use.

What it does

Diagram retrieval
Get a diagram as Mermaid or JSON with a canvas link.
Pull request deltas
See what a PR or re-parse changes.
Resource detail
Type, attributes and relationships for one resource.
Diagram validation
Check a diagram the agent wrote and list problems by line.
Headless credentials
MCP credential for CI or shared machines.

Good for

  • Ask what a PR changes in infrastructure
  • Draw an architecture diagram from IaC
  • Inspect one resource's relationships
  • Validate and save an agent-written diagram

Pricing

Freemium

A Pro tier exists; prices not published here

Prices change. Check arcsync.dev before you buy.

ArcSync FAQ

Which IaC formats are supported?

Terraform, CDK, CloudFormation, Pulumi, ARM and Serverless Framework.

What needs Node?

Node 22+ for the npx setup.

Can it delete my diagrams?

No.

How do I sign in on CI?

Create an MCP credential and set ARCSYNC_CLIENT_ID and ARCSYNC_CLIENT_SECRET.

Is ArcSync free?

ArcSync has a free plan, with paid plans for more usage or features.

How do I add ArcSync to Claude Code?

Run this command in your terminal: claude mcp add arcsync-mcp --env ARCSYNC_CLIENT_SECRET='<ARCSYNC_CLIENT_SECRET>' -- npx -y arcsync-mcp

What are the best alternatives to ArcSync?

The closest alternatives to ArcSync are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to ArcSync

  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. 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
  3. 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
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. 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
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools