# AI Software Architect MCP server

> Lets an AI client set up architecture docs, create ADRs, list reviewers, check status, and get implementation guidance in markdown projects.

- Repository: https://github.com/codenamev/ai-software-architect
- Page: https://hostedmcp.org/servers/codenamev/ai-software-architect
- Transport: —
- Stars: 80

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `CLAUDE_PLUGIN_ROOT` | no | no |  |

## FAQ

### How do I install AI Software Architect as an MCP server?

Run npm install -g ai-software-architect, then register it with your client using the mcp command, for example claude mcp add ai-software-architect -- mcp. You can also add it to your .mcp.json or Cursor settings.

### Does the MCP server support architecture reviews?

No. Reviews, specialist reviews, and pragmatic enforcement are Tier-2 capabilities that need LLM reasoning and are only available through the Claude Code plugin's Skills, not as MCP tools.

### What can the MCP server do for my project?

It exposes six deterministic tools: setup_architecture, create ADR, list members, get status, configure pragmatic mode, and implementation guidance. The five non-setup tools read the project's own .architecture/ directory.

### Which AI clients can use this server?

It works with Claude Code and Cursor, with limited MCP support in GitHub Copilot and Codex. For Copilot and Codex the README recommends the traditional setup instead.

### What configuration does setup_architecture need in Cursor?

Point the CLAUDE_PLUGIN_ROOT environment variable at a clone of the repository, since Cursor has no Claude Code plugin to fall back on. The other tools do not need it once .architecture/ exists.
