AsDecided
Deterministic, read-only retrieval of engineering decisions stored as Markdown in a repo
- 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.2Add to claude_desktop_config.json
{
"mcpServers": {
"core": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/asdecided/core:mcp-v0.31.2"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"core": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/asdecided/core:mcp-v0.31.2"
]
}
}
}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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools