How does Mason keep context fresh and avoid stale information?

It uses a drift engine that proofs staleness without LLMs and runs a self-maintaining refresh loop, ensuring the concept map and decisions are up to date.

How is the concept map created and maintained?

The assistant builds the map by reading the project and writing features and flows to files in a snapshot JSON; it does not parse code but captures architectural intent.

What does the get_context call provide?

It returns relevant features, files, tests, blast radius (co-change and references), matching decisions, and a freshness verdict for a given task.

Is Mason a standalone CLI tool?

No, since version 0.4.0 Mason operates exclusively as an MCP server driven by AI assistants, with no separate CLI commands.

Mason

developer-toolscontext-engineeringgitdecision-records

MCP server that maintains a concept map, decision records, and freshness checks to provide persistent project context beyond code.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

We couldn’t automatically confirm this listing starts correctly

We ran the install command below but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y -p

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

This MCP server generates and maintains a concept map linking features and flows to files, records team decisions as JSON files, and tracks context freshness via a drift engine. It enables AI assistants to quickly retrieve relevant project knowledge that is not directly derivable from code, such as architectural intent, change history, and team decisions. Use it to improve AI agent understanding and reduce redundant code exploration in development workflows.

Use cases

Generate a concept map linking features and flows to source files

Record and retrieve team engineering decisions as versioned JSON files

Detect stale context and trigger refreshes to keep knowledge up to date

Provide AI assistants with task-scoped relevant context in one call

Improve agent accuracy on questions requiring non-code knowledge

Key features

Concept map snapshot of features/flows to files

Decision records stored as git-committed JSON files

Drift engine for freshness verification and self-maintaining refresh

Task-scoped context assembly via get_context call

Verification of map correctness with verify_snapshot

Integration with CLAUDE.md for assistant routing

Capabilities & Tool Schemas (18)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Mason.

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.

Documentation Overview

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

Get started

Install on macOS or Linux:

Terminal

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 · npm installation

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 · Disconnect a project · Other MCP 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

Documentation

Read the full README →View source on GitHub →

Related MCP Servers

View all in Workplace & Productivity View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

Today

Most recent push to the default branch.

Install check

Inconclusive

Didn't respond in our test window — often a slow first install.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Mason

Mason stores decision records as JSON files in a git-committed directory, representing team knowledge like failed approaches or conventions.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/adrianczuczka-mason?style=directory)](https://allmcps.com/mcp/adrianczuczka-mason)

HTML Embed

<a href="https://allmcps.com/mcp/adrianczuczka-mason"><img src="https://allmcps.com/api/badge/adrianczuczka-mason?style=directory" alt="Mason on AllMCPs" /></a>

Technical Specs & Signals

CategoryWorkplace & Productivity

PricingFree

59Quality signal: Good · 59/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools28/30

Adoption & activity6/15

Community engagement0/10

A guidance signal from public completeness & health data — not a user rating. New listings start lower and rise as they add docs, get verified, and grow adoption. Signals we can't observe for a listing are skipped, not counted against it.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 24d ago via OSV.dev · -p (npm)

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

This directory is pre-filled from public sources. Claim via GitHub README, site badge, or DNS TXT to unlock edit access and the Official badge — proof is checked automatically, then reviewed by our team.

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🏢 Workplace & Productivity →Best MCP servers for Workplace & Productivity →Alternatives to Mason →Install in Claude Desktop Install in Cursor Install in VS Code

Mason

developer-toolscontext-engineeringgitdecision-records

MCP server that maintains a concept map, decision records, and freshness checks to provide persistent project context beyond code.

Quick Install

Automated & IDE Setup

Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.

Add to Cursor Add to VS Code

We couldn’t automatically confirm this listing starts correctly

We ran the install command below but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y -p

No response to initialize.

Manual Client & Custom JSON ConfigExpand JSON ▾

Client Config & Setup

Choose your client or environment

Target File:~/Library/Application Support/Claude/claude_desktop_config.json

claude_desktop_config.json

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

💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.

Overview

Use cases

Generate a concept map linking features and flows to source files

Record and retrieve team engineering decisions as versioned JSON files

Detect stale context and trigger refreshes to keep knowledge up to date

Provide AI assistants with task-scoped relevant context in one call

Improve agent accuracy on questions requiring non-code knowledge

Key features

Concept map snapshot of features/flows to files

Decision records stored as git-committed JSON files

Drift engine for freshness verification and self-maintaining refresh

Task-scoped context assembly via get_context call

Verification of map correctness with verify_snapshot

Integration with CLAUDE.md for assistant routing

Capabilities & Tool Schemas (18)Self-reported

Inspect callable tools, capabilities, and parameters exposed to AI agents by Mason.

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.

Documentation Overview

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

Get started

Install on macOS or Linux:

Terminal

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 · npm installation

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

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

Documentation

Read the full README →View source on GitHub →

Related MCP Servers

View all in Workplace & Productivity View all alternatives

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars

Stargazers on the source repository.

Last commit

Today

Most recent push to the default branch.

Install check

Inconclusive

Didn't respond in our test window — often a slow first install.

Tools exposed

Callable tools this server registers over MCP.

Directory activity

2 views

Config copies, upvotes, and views on AllMCPs.

Reviews

No reviews yet — be the first to share how this listing worked for you.

Frequently Asked Questions about Mason

Mason stores decision records as JSON files in a git-committed directory, representing team knowledge like failed approaches or conventions.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:

Live Dynamic SVG Preview

Markdown (GitHub README)

[![AllMCPs](https://allmcps.com/api/badge/adrianczuczka-mason?style=directory)](https://allmcps.com/mcp/adrianczuczka-mason)

HTML Embed

<a href="https://allmcps.com/mcp/adrianczuczka-mason"><img src="https://allmcps.com/api/badge/adrianczuczka-mason?style=directory" alt="Mason on AllMCPs" /></a>

Technical Specs & Signals

CategoryWorkplace & Productivity

PricingFree

59Quality signal: Good · 59/100How this signal is calculated ▾

Server availabilityNot measured

Not scored for repo-hosted servers — we can't reach the running server, only its GitHub page. Hosted MCP endpoints are health-checked live.

Verified ownership10/20

Documentation & tools28/30

Adoption & activity6/15

Community engagement0/10

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 24d ago via OSV.dev · -p (npm)

★ Spotlight Slot

Feature Your MCP Server

Get maximum visibility for your server across our directory, search results, and detail pages.

Spotlight Your Server

Own this project?

Free dofollow backlink: add your website and place the AllMCPs badge on it — no claim needed. We detect it automatically and keep it verified as long as the badge stays live.

Claim & get free dofollow

Share & Embed

Add our SVG badge (dark/light directory styles) or embeddable widget to your site.

Explore more

More in 🏢 Workplace & Productivity →Best MCP servers for Workplace & Productivity →Alternatives to Mason →Install in Claude Desktop Install in Cursor Install in VS Code