Skip to content
MCP server

AsDecided

Deterministic, read-only retrieval of engineering decisions stored as Markdown in a repo

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, macOS
Runs
Locally
Version
0.31.2
Listing updated
1 day ago

About AsDecided

AsDecided is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

AsDecided keeps architectural decisions as validated Markdown beside the code and lets an agent ask which of them apply to a repository, path or capability. Retrieval uses no embeddings and no model call, so the same repository state gives the same answer, and each returned decision has a stable ID and source that an agent can cite in a plan or pull request.

The design separates three jobs: record why the team chose a path, retrieve current authority before code changes, and enforce only what can be checked objectively through architecture tests, policies or CI gates. The project says it does not treat a model's judgement as proof. The Rust engine also holds requirements, designs, roadmaps and prompts as typed Markdown, validates them and can federate several pinned parent corpora offline.

It installs through Homebrew, Cargo, Scoop or release archives, and the MCP server is also published as a container that needs an explicit read-only mount of the repository. Its CLI includes quickstart, validate and gate commands.

Install

Run in a terminal

claude mcp add core -- docker run -i --rm ghcr.io/asdecided/core:mcp-v0.31.2

Add to claude_desktop_config.json

{
  "mcpServers": {
    "core": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/asdecided/core:mcp-v0.31.2"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "core": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/asdecided/core:mcp-v0.31.2"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "core": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/asdecided/core:mcp-v0.31.2"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "core": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/asdecided/core:mcp-v0.31.2"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "core": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/asdecided/core:mcp-v0.31.2"
      ]
    }
  }
}

What it does

Deterministic retrieval
Returns the same cited decisions for the same repository state.
Stable decision IDs
Lets agents cite the exact authority behind a plan or pull request.
Validation and gates
Checks records and can gate code changes against decisions in CI.
Corpus federation
Combines pinned parent corpora offline with source tracking.
Read-only MCP
Serves records without writing to the repository.
No model dependency
Needs no embeddings, hosted index or model call.

Good for

  • Tell a coding agent which decisions govern a path
  • Cite an architecture decision in a pull request
  • Gate a merge on objectively checkable rules
  • Share organisation standards across repositories

Pricing

Open source

Open source core; install via Homebrew, Cargo or Scoop

Prices change. Check asdecided.com before you buy.

AsDecided FAQ

Does it use AI to find decisions?

No. Retrieval is deterministic with no embeddings or model calls.

How do I install it?

Through Homebrew, Cargo, Scoop or prebuilt release binaries; the MCP server is also a container image.

Can the server change my files?

No. It is read-only and the container needs an explicit repository mount.

Where are decisions stored?

As validated Markdown in a decisions folder in your repository.

Is AsDecided free?

Yes. AsDecided is open source, so you can use and self-host it for free.

How do I add AsDecided to Claude Code?

Run this command in your terminal: claude mcp add core -- docker run -i --rm ghcr.io/asdecided/core:mcp-v0.31.2

What are the best alternatives to AsDecided?

The closest alternatives to AsDecided are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to AsDecided

  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