# ALIGN

> ALIGN is a freemium MCP server for developer tools. Decision ledger MCP server that gives coding agents your team's confirmed decisions. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $15 a month
- **Platforms:** CLI, macOS, Linux
- **Website:** https://align.bharatreachdsp.com
- **Repository:** https://github.com/bharatreachdsp/align-cli
- **MCP Registry name:** io.github.bharatreachdsp/align
- **Categories:** developer tools, knowledge and memory
- **Listing updated:** 2026-11-14

## About

ALIGN runs as a local stdio server from the npm package @align-agent/cli (Node 22.14 or later, macOS or Linux, Windows through WSL). Running align init connects a repository, merges hooks into Claude Code, Cursor and Codex settings, and installs two git hooks; align uninstall removes exactly what it added.

The idea is that a decision spoken in a coding session, such as choosing Postgres advisory locks over Redis, becomes a proposal with the exact quote and transcript lines. A person confirms it and it gets a permanent id like AL-7. Agents are then told about confirmed decisions at session start or by asking through MCP, and pull requests can be checked against them with a single comment and a neutral check.

Prompts and replies from opted-in repositories are sent with secrets removed and code blocks replaced on the laptop. File contents, tool output, diffs and .env files are never sent.

## Features

- **Receipts for decisions:** Every ledger entry carries the quote and transcript reference that justify it.
- **Served to every agent:** Session-start packs and MCP lookups give Claude Code, Cursor and Codex the same decisions.
- **Pull request checks:** Flags changes that conflict with a decision, with at most one comment per PR.
- **Local redaction:** Secrets and fenced code are stripped on your machine before anything is sent.
- **Opt-in per repository:** Hooks only run in repositories you enable, and align off stops capture at once.
- **Open export:** Everything can be exported in open formats.

## Good for

- Stop agents from reintroducing a library the team ruled out
- Give a new engineer the reasons behind past architecture choices
- Check a pull request against confirmed team decisions
- Keep decisions consistent across Claude Code, Cursor and Codex sessions

## Install

### Claude Code (Terminal)

```sh
claude mcp add align -- npx -y @align-agent/cli
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "align": {
      "command": "npx",
      "args": [
        "-y",
        "@align-agent/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "align": {
      "command": "npx",
      "args": [
        "-y",
        "@align-agent/cli"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "align": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@align-agent/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "align": {
      "command": "npx",
      "args": [
        "-y",
        "@align-agent/cli"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "align": {
      "command": "npx",
      "args": [
        "-y",
        "@align-agent/cli"
      ]
    }
  }
}
```

## Tools

- `search_decisions`: Searches the team's confirmed decisions.
- `get_decision`: Returns one decision with its receipt.

## FAQ

### What does it cost?

Free covers 3 contributors and 3 repositories. Team is $15 per contributor per month billed yearly ($19 monthly), with a 3-contributor minimum, and Business is $29 yearly.

### Which MCP tools can agents call?

The site names search_decisions and get_decision.

### What leaves my machine?

Prompts and replies from opted-in repositories with secrets removed, repo paths touched, commit messages and confirmed decisions. File contents are never sent.

### What licence is the CLI under?

MIT.

### Is ALIGN free?

ALIGN has a free plan, with paid plans for more usage or features. Paid plans start at $15 a month.

### How do I add ALIGN to Claude Code?

Run this command in your terminal: claude mcp add align -- npx -y @align-agent/cli

### What are the best alternatives to ALIGN?

The closest alternatives to ALIGN 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.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/align-2
