# ArcSync

> ArcSync is a freemium MCP server for cloud and infrastructure. Architecture graphs parsed from your infrastructure code, for coding agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI
- **Website:** https://arcsync.dev/docs/mcp
- **Repository:** https://github.com/vanlandinghamlabs/arcsync-mcp
- **MCP Registry name:** io.github.VanLandinghamLabs/arcsync-mcp
- **Categories:** cloud and infrastructure, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## Tools

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

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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

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