# adrianczuczka/mason [Health: Active]

**Category:** 🏢 Workplace & Productivity  
**Repository:** https://github.com/adrianczuczka/mason  
**GitHub Stars:** 7  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/adrianczuczka-mason

## Description
Context engineering MCP server. Generates CLAUDE.md from git history and architectural file sampling, and maintains a concept-map snapshot of features/flows → files so agents can skip grep/glob on repeat queries.

## Tools
Capabilities this server exposes over MCP:

- **mason_init** — Start here.** Returns the Map-Reduce setup playbook. Idempotent.
- **mason_complete_init** — Marks the project as initialized once the playbook is done.
- **generate_snapshot_batch** — Map step — returns one batch of files for the assistant to summarize.
- **save_partial_snapshot** — Persists the partial map for one batch.
- **reduce_snapshot** — Reduce step — returns every partial + instructions to merge into a unified map.
- **save_snapshot** — Persist the final unified map. Clears partials.
- **mason_set_confluence** — Configure Confluence credentials — two-step: list spaces, then persist.
- **export_to_confluence** — Sync the concept map to Confluence as PM-readable wiki pages.
- **get_snapshot** — First call for any architecture question.** Loads the concept map — feature → file lookup — in one LLM-free call.
- **get_context** — First call for any task or bug.** Matching features + files + tests + blast radius + freshness + recorded decisions, in one call.
- **save_decision** — Record knowledge the code can't express — failed approaches, deprecations, conventions. Git-committed, PR-reviewed, drift-checked.
- **mason_check_drift** — Feature-level staleness report — what changed since the snapshot, and whether to refresh incrementally or rebuild.
- **verify_snapshot** — Spot-check map correctness — sampled entries + file skeletons for the assistant to judge, least-recently-verified first.
- **save_verification** — Record verification verdicts — failures flag entries for re-mapping until fixed.
- **get_impact** — Call before editing a file.** Traces what's affected — co-change history + references + related tests.
- **analyze_project** — Git stats — hot files, stale dirs, commit conventions.
- **full_analysis** — One-shot orientation for unmapped projects: structure + samples + tests + git.
- **get_code_samples** — Smart file previews selected by architectural role.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "mason": {
    "command": "npx",
    "args": ["-y","-p"]
  }
}
```

## Documentation & README

<div align="center">

# Mason

### Your agents are creating tech debt. Mason helps you prevent it.

**Remember why decisions were made · Catch outdated guidance · Find what else needs updating**

[![npm version](https://img.shields.io/npm/v/mason-context?style=flat-square&labelColor=334155&color=2563eb)](https://www.npmjs.com/package/mason-context)
[![CI](https://img.shields.io/github/actions/workflow/status/adrianczuczka/mason/ci.yml?branch=main&style=flat-square&labelColor=334155&label=CI)](https://github.com/adrianczuczka/mason/actions/workflows/ci.yml)
[![Monthly downloads](https://img.shields.io/npm/dm/mason-context?style=flat-square&labelColor=334155&color=2563eb)](https://www.npmjs.com/package/mason-context)
[![License](https://img.shields.io/github/license/adrianczuczka/mason?style=flat-square&labelColor=334155&color=64748b)](https://github.com/adrianczuczka/mason/blob/main/LICENSE)

[![Works with Codex](https://img.shields.io/badge/Codex-supported-64748b?style=flat-square&labelColor=334155)](https://github.com/adrianczuczka/mason/blob/main/docs/setup.md)
[![Works with Claude Code](https://img.shields.io/badge/Claude%20Code-supported-64748b?style=flat-square&labelColor=334155)](https://github.com/adrianczuczka/mason/blob/main/docs/setup.md)
[![MCP compatible](https://img.shields.io/badge/MCP-compatible-64748b?style=flat-square&labelColor=334155)](https://github.com/adrianczuczka/mason/blob/main/docs/setup.md#other-clients)
[![Supported platforms](https://img.shields.io/badge/platforms-macOS%20%7C%20Linux%20%7C%20Windows-64748b?style=flat-square&labelColor=334155)](https://github.com/adrianczuczka/mason/blob/main/docs/distribution.md)

</div>

## Get started

Install on macOS or Linux:

```sh
curl -fsSL https://github.com/adrianczuczka/mason/releases/latest/download/install.sh | sh
```

Windows PowerShell:

```powershell
irm https://github.com/adrianczuczka/mason/releases/latest/download/install.ps1 | iex
```

No Node or npm required. Git is required. The installer configures PATH for Bash, Zsh, and Windows. [Platform details](https://github.com/adrianczuczka/mason/blob/HEAD/docs/distribution.md) · [npm installation](https://github.com/adrianczuczka/mason/blob/HEAD/docs/setup.md#unified-project-setup)

Run this in your Git repository (open a new terminal if the installer asks):

```bash
mason setup --host codex
# For Claude Code, use --host claude.
```

Setup connects MCP, hooks, and project instructions. Review your host's trust settings, start a new session, and give your agent a normal task.

Check that Mason is being used:

```bash
mason status
```

Setup uses your installed `mason` command—no project launch scripts or runtime copies. Status distinguishes configuration from observed use. [Setup and upgrades](https://github.com/adrianczuczka/mason/blob/HEAD/docs/setup.md#unified-project-setup) · [Disconnect a project](https://github.com/adrianczuczka/mason/blob/HEAD/docs/setup.md#disconnect-a-project) · [Other MCP clients](https://github.com/adrianczuczka/mason/blob/HEAD/docs/setup.md#other-clients)

### Try a check without setup

```bash
mason audit --dir .
mason review --dir . --base origin/main
```

The audit checks claims in README and agent instruction files throughout the repository. The review checks committed changes against your chosen base. Both are read-only and need no model calls.

## What Mason catches

| As your project grows… | Mason helps by… |
|---|---|
| Instructions fall behind the code. | Flagging missing paths, incorrect workspace counts, and missing npm scripts. |
| A patch misses a related update. | Surfacing references, related tests, and files that historically change together. |
| Old decisions lose their context. | Retrieving recorded rationale and review status, and flagging changes to the code they apply to. |
| A repair gets interrupted. | Retaining the original findings and verifying them through the final documentation commit. |

After resolving an incident or settling a constraint, ask your agent to record the reason with Mason. Later tasks can retrieve it. Proposals and accepted decisions stay distinct.

Mason complements tests, linters, and code review. Findings are evidence to inspect; unavailable checks stay explicit.

## Evidence so far

Earlier read-only decision-retrieval evaluations scored **9.0/10 with Mason vs 7.0/10 without**. The initial ten-task patch comparison tied at **10/10 for both**. Improved patch outcomes remain to be demonstrated. [Results, methodology, and limitations](https://github.com/adrianczuczka/mason/blob/HEAD/docs/benchmarks.md)

## Documentation

- [Setup, hooks, and upgrades](https://github.com/adrianczuczka/mason/blob/HEAD/docs/setup.md)
- [Data and network behavior](https://github.com/adrianczuczka/mason/blob/HEAD/docs/data-and-network.md) · [Hook performance](https://github.com/adrianczuczka/mason/blob/HEAD/docs/hook-performance.md)
- [Audits, repair verification, and CI evidence](https://github.com/adrianczuczka/mason/blob/HEAD/docs/checks.md)
- [Decisions, tools, and optional architecture maps](https://github.com/adrianczuczka/mason/blob/HEAD/docs/reference.md)
- [Roadmap](https://github.com/adrianczuczka/mason/blob/HEAD/ROADMAP.md) · [Changelog](https://github.com/adrianczuczka/mason/blob/HEAD/CHANGELOG.md) · [MIT license](https://github.com/adrianczuczka/mason/blob/HEAD/LICENSE)