Skip to content
MCP server

ALIGN

Decision ledger MCP server that gives coding agents your team's confirmed decisions

Runs locallyStatus and history
Install
Pricing
Freemium
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.1.7
Listing updated
3 days ago

About ALIGN

ALIGN is a freemium MCP server for developer tools. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "align": {
      "command": "npx",
      "args": [
        "-y",
        "@align-agent/cli"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "align": {
      "command": "npx",
      "args": [
        "-y",
        "@align-agent/cli"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

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

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

Tools this server provides (2)

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

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

What it does

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

Pricing

Freemium, from $15 a month

Free for 3 contributors and 3 repositories; Team $15 per contributor per month billed yearly; Business $29

Prices change. Check align.bharatreachdsp.com before you buy.

ALIGN 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 to ALIGN

  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