# RTFM

> RTFM is an open-source MCP server for knowledge and memory. Index code, docs, PDFs and data in a local SQLite file and serve context to agents. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows, self-hosted
- **Website:** https://rtfm.roomi-fields.com
- **Repository:** https://github.com/roomi-fields/rtfm
- **MCP Registry name:** io.github.roomi-fields/rtfm
- **Categories:** knowledge and memory, developer tools
- **Listing updated:** 2026-11-14

## About

RTFM exists because its author watched Claude Code grep the same folders in loops while writing a French tax article from about 50 pages of regulation. The fix is retrieval: one query returns ranked pointers, about three results and 300 tokens, and the agent calls `rtfm_expand(source, target_section)` to read more.

Everything lives in `.rtfm/library.db`, a single SQLite file. Search defaults to FTS5, with optional local embeddings through FastEmbed and ONNX. It has 24 built-in parsers covering Python AST, Markdown headers, XML legal text, LaTeX, CSV and XLSX, Jupyter notebooks and SQLite, and you can add formats with about 50 lines of Python or 30 lines of YAML.

On the author's own task the site reports a cost drop from $22.61 to $11.14. That figure is the project's benchmark, not an independent test.

## Features

- **Single SQLite index:** One local file holds the whole knowledge base.
- **24 parsers:** Code, Markdown, legal XML, LaTeX, tables, notebooks and databases.
- **Expandable results:** Short ranked hits, then rtfm_expand for a section.
- **Local only:** No cloud, API keys or telemetry.
- **Declarative mappings:** Map JSON schemas to chunks with YAML.
- **Obsidian vault mode:** Search large note vaults.

## Good for

- Find the right spec section before editing code
- Search PDFs and regulations alongside source
- Cut down grep loops in a large repo
- Index an Obsidian vault for an agent

## Install

### Claude Code (Terminal)

```sh
claude mcp add rtfm -- uvx rtfm-ai
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "rtfm": {
      "command": "uvx",
      "args": [
        "rtfm-ai"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "rtfm": {
      "command": "uvx",
      "args": [
        "rtfm-ai"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "rtfm": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "rtfm-ai"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "rtfm": {
      "command": "uvx",
      "args": [
        "rtfm-ai"
      ]
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "rtfm": {
      "command": "uvx",
      "args": [
        "rtfm-ai"
      ]
    }
  }
}
```

## Tools

- `rtfm_expand`: Read more of a search hit by source and target section.

## FAQ

### Does it need a cloud service?

No. The docs say it runs locally with no accounts, API keys or quotas.

### Is it a vector database?

No. Default search is FTS5; embeddings are optional and local.

### How do I start?

Install the Claude Code plugin or pip install rtfm-ai, then run rtfm init in your project.

### What licence?

MIT.

### Is RTFM free?

Yes. RTFM is open source, so you can use and self-host it for free.

### How do I add RTFM to Claude Code?

Run this command in your terminal: claude mcp add rtfm -- uvx rtfm-ai

### What are the best alternatives to RTFM?

The closest alternatives to RTFM are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [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.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/rtfm
