# Khavion Architecture Review

> Khavion Architecture Review is a free MCP server for cloud and infrastructure. Quote cloud providers' own best practices and review Terraform and Kubernetes files. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, API
- **Website:** https://khavion.com/tools/mcp
- **Repository:** https://github.com/khavion/architecture-review-mcp
- **MCP Registry name:** com.khavion/architecture-review-mcp
- **Categories:** cloud and infrastructure, developer tools
- **Listing updated:** 2026-11-14

## About

Nothing in this server calls an AI model. Findings come from a fixed, version-controlled rule set, so the same input always yields the same output, and citation lookups return the provider's own sentence quoted word for word with a link to the page it came from.

It runs locally over stdio on Node 20 or later and reads files on your machine. The site says the only things that leave it are your key, rule ids and one number, the count of services found, and only when a key is used. No file contents are sent.

Without a key, lookups are complete but a review shows the top three findings. A free key from a work email unlocks every finding, an estimated quote total, a recommended next step and a link to the full report; the price lines are estimates, not offers. The same engine also ships as a command line tool and a GitHub Action that comments on pull requests.

## Features

- **Verbatim citations:** Returns up to five cited rules for a service, each with a quote and its source page.
- **Infrastructure review:** Reviews Terraform, CloudFormation or Kubernetes files you point it at.
- **Stack review:** Reviews a list of named services with an optional workload description.
- **Finding explanations:** Explains why a finding matters, the fix and its citation.
- **Deterministic rules:** Fixed rule set, no model and no file contents sent.

## Good for

- Check a Terraform change before a pull request
- Get the provider's own wording for a design question
- Sanity-check a proposed list of cloud services
- Comment top findings on PRs through the GitHub Action

## Install

### Claude Code (Terminal)

```sh
claude mcp add architecture-review-mcp --env KHAVION_API_KEY='<KHAVION_API_KEY>' -- npx -y @khavion/architecture-review-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "architecture-review-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@khavion/architecture-review-mcp"
      ],
      "env": {
        "KHAVION_API_KEY": "<KHAVION_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "architecture-review-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@khavion/architecture-review-mcp"
      ],
      "env": {
        "KHAVION_API_KEY": "<KHAVION_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "architecture-review-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@khavion/architecture-review-mcp"
      ],
      "env": {
        "KHAVION_API_KEY": "<KHAVION_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "architecture-review-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@khavion/architecture-review-mcp"
      ],
      "env": {
        "KHAVION_API_KEY": "<KHAVION_API_KEY>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "architecture-review-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@khavion/architecture-review-mcp"
      ],
      "env": {
        "KHAVION_API_KEY": "<KHAVION_API_KEY>"
      }
    }
  }
}
```

## Tools

- `lookup_citation`: Returns up to five cited rules for a service, pillar and question.
- `review_iac`: Reviews Terraform, CloudFormation or Kubernetes file contents.
- `review_stack`: Reviews a list of services with an optional workload description.
- `explain_finding`: Explains one finding with why it matters, the fix and the citation.

## FAQ

### Is it free?

Yes. A free key from a work email shows full reviews.

### What does it send off my machine?

Only your key, rule ids and a service count, and only when a key is used.

### What runs it?

Node 20 or later via npx -y @khavion/architecture-review-mcp.

### What is limited without a key?

Reviews show the top three findings; citation lookup stays complete.

### Is Khavion Architecture Review free?

Yes. Khavion Architecture Review is free to use.

### How do I add Khavion Architecture Review to Claude Code?

Run this command in your terminal: claude mcp add architecture-review-mcp --env KHAVION_API_KEY='<KHAVION_API_KEY>' -- npx -y @khavion/architecture-review-mcp

### What are the best alternatives to Khavion Architecture Review?

The closest alternatives to Khavion Architecture Review 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/khavion-architecture-review
