Rational Agnostic
File-based record of decisions, tasks and shared memory for coding agents of any vendor
- Pricing
- Open source
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- Version
- 0.1.7
- Listing updated
- today
Similar MCP servers
About Rational Agnostic
Rational Agnostic is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
rational-agnostic keeps a durable, plain-file record that Claude Code, Codex, Cursor, Copilot, Gemini CLI and other agents all read and write. Decisions are saved as ADR-style files explaining why, in English, and code is tagged with a comment such as // @why: D-ea3ec7 so a function can be traced to its decision, by location or by SHA-256 hash.
The store also holds one file per task with a status board, a shared memory file for cross-agent notes, and distilled learnings. A get_context tool returns a minimal bundle within a token budget. Search runs on a built-in lexical embedder with no downloads, and an optional local transformer model can be installed for better retrieval.
Running init scaffolds AGENTS.md and writes MCP config for each supported client. An adopt command inventories an existing codebase read-only and can record an as-built baseline. Every operation is also a CLI command, and a verify command can gate commits.
Install
Run in a terminal
claude mcp add rational-agnostic -- npx -y rational-agnosticAdd to claude_desktop_config.json
{
"mcpServers": {
"rational-agnostic": {
"command": "npx",
"args": [
"-y",
"rational-agnostic"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"rational-agnostic": {
"command": "npx",
"args": [
"-y",
"rational-agnostic"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"rational-agnostic": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"rational-agnostic"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"rational-agnostic": {
"command": "npx",
"args": [
"-y",
"rational-agnostic"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"rational-agnostic": {
"command": "npx",
"args": [
"-y",
"rational-agnostic"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (13)
Taken from the project documentation; the running server may differ.
- get_context
- Returns a minimal relevant context bundle within a token budget.
- search
- Searches decisions, tasks and knowledge.
- record_decision
- Records a decision file.
- tag_code
- Tags code with a decision reference.
- create_task
- Creates a task file.
- set_task_status
- Updates a task's status.
- read_memory
- Reads shared memory.
- append_memory
- Appends to shared memory.
- record_learning
- Records a learning.
- distill
- Distills recurring patterns into learnings.
- verify
- Checks tags and task status for problems.
- adopt_report
- Inventories an existing codebase read-only.
- start_adoption
- Starts the adoption task and baseline.
What it does
- Decision records
- Stores each non-trivial choice as an ADR-style file with context and reasoning.
- Code traceability
- Links functions to decisions through @why tags and hashes.
- Shared agent memory
- Gives agents of different vendors one place for notes and task state.
- Token-aware context
- Returns a relevant bundle within a set token budget.
- Commit gate
- Verify exits non-zero on orphan tags or bad task status.
- Zero-config wiring
- Init writes MCP settings for Claude Code, Cursor, Codex, Gemini CLI and Copilot.
Good for
- Record why an architecture choice was made
- Find the decision behind a function
- Hand work between different coding agents
- Onboard an existing codebase with an adoption plan
- Block commits with dangling decision tags
Pricing
Open source
Open-source npm package
Rational Agnostic FAQ
How many tools does it expose?
22, including get_context, search, record_decision, tag_code, create_task and verify.
Where is data stored?
In an .rational-agnostic folder in your repo, as markdown and JSON files.
Does it need an API key for search?
No. A lexical embedder is built in; a local model is optional.
Can I use it without MCP?
Yes. Every operation is also a CLI command.
Is Rational Agnostic free?
Yes. Rational Agnostic is open source, so you can use and self-host it for free.
How do I add Rational Agnostic to Claude Code?
Run this command in your terminal: claude mcp add rational-agnostic -- npx -y rational-agnostic
What are the best alternatives to Rational Agnostic?
The closest alternatives to Rational Agnostic are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.


