Skip to content
MCP server

Rational Agnostic

File-based record of decisions, tasks and shared memory for coding agents of any vendor

Runs locallyStatus and history
Install
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-agnostic

Add to claude_desktop_config.json

{
  "mcpServers": {
    "rational-agnostic": {
      "command": "npx",
      "args": [
        "-y",
        "rational-agnostic"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "rational-agnostic": {
      "command": "npx",
      "args": [
        "-y",
        "rational-agnostic"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers