# AsDecided

> AsDecided is an open-source MCP server for developer tools. Deterministic, read-only retrieval of engineering decisions stored as Markdown in a repo. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Website:** https://asdecided.com
- **Repository:** https://github.com/asdecided/core
- **MCP Registry name:** io.github.asdecided/core
- **Categories:** developer tools, knowledge and memory
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

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

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

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

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

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

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

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

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

## 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

- [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/asdecided
