AsDecided — Claude Code MCP server: what it does, how to install
Grants coding agents read-only access to local architectural decisions and project roadmaps. It works entirely offline without embeddings or runtime model calls.
claude mcp add asdecided -- docker run -i --rm ghcr.io/asdecided/core:mcp-v0.31.2What AsDecided does
AsDecided exposes typed Markdown documents stored in decisions/ and .decided/config.yaml directly to development agents. A native Rust engine inspects the files, verifies schema compliance, and retrieves relevant records. Identical repository commits yield identical context. The tool keeps development strictly aligned with settled architecture.
Indexing avoids vector stores, hosted indices, and Python runtimes altogether. Linux binaries require glibc 2.17 or newer. The server operates exclusively read-only, ensuring that an agent cannot alter or overwrite approved design documents.
What it helps with
- anchor coding agents to verified architecture decision records
- retrieve design context without hosted vector indices or API fees
- verify pull requests against project constraints before merging
- federate multiple documentation corpora across local repositories
Example prompts for the agent
- Check my new service design against the decisions in the repository
- What standard did we decide on for database connection pooling?
- Review this diff against the constraints in .decided/config.yaml
How to install AsDecided
Platform CLI
claude mcp add asdecided -- docker run -i --rm ghcr.io/asdecided/core:mcp-v0.31.2Platform CLI
codex mcp add asdecided -- docker run -i --rm ghcr.io/asdecided/core:mcp-v0.31.2Config file
{
"mcpServers": {
"asdecided": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/asdecided/core:mcp-v0.31.2"
]
}
}
}Config file
{
"servers": {
"asdecided": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/asdecided/core:mcp-v0.31.2"
]
}
}
}Platform CLI
gemini mcp add asdecided docker run -i --rm ghcr.io/asdecided/core:mcp-v0.31.2Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about AsDecided
How do I install AsDecided in Claude Code?
Run claude mcp add asdecided -- docker run -i --rm ghcr.io/asdecided/core:mcp-v0.31.2. This pulls the server container and links it over stdio.
What does AsDecided do?
It validates local decision records and serves them to AI agents as read-only context, keeping generated code compliant with your ADRs.
Does AsDecided require Python or external vector databases?
No. The engine is written in Rust and delivers deterministic queries without embeddings, hosted indices, or a Python runtime.
