# Rational Agnostic

> Rational Agnostic is an open-source MCP server for developer tools. File-based record of decisions, tasks and shared memory for coding agents of any vendor. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows
- **Repository:** https://github.com/fagugon283/rational
- **MCP Registry name:** io.github.fagugon283/rational-agnostic
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [knowledge and memory](https://ai-powered.com/categories/knowledge-and-memory)
- **Listing updated:** 2026-11-18

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
claude mcp add rational-agnostic -- npx -y rational-agnostic
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "rational-agnostic": {
      "command": "npx",
      "args": [
        "-y",
        "rational-agnostic"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "rational-agnostic": {
      "command": "npx",
      "args": [
        "-y",
        "rational-agnostic"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "rational-agnostic": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "rational-agnostic"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "rational-agnostic": {
      "command": "npx",
      "args": [
        "-y",
        "rational-agnostic"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "rational-agnostic": {
      "command": "npx",
      "args": [
        "-y",
        "rational-agnostic"
      ]
    }
  }
}
```

## Tools

- `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.

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

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [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.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers 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.

---
Source: https://ai-powered.com/mcp/rational-agnostic
