# Cairn MCP server

> Provides AI agents with a navigable documentation graph for repositories and structured documents using hierarchical summaries and semantic search.

- Repository: https://github.com/jokeuncle/cairn
- Page: https://hostedmcp.org/servers/jokeuncle/cairn
- Transport: —
- Stars: 1
- License: Apache-2.0

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `CAIRN_EMBED_API_KEY` | no | no |  |
| `CAIRN_EMBED_MODEL` | no | no |  |
| `CAIRN_EMBED_PROVIDER` | no | no |  |
| `CAIRN_LLM_API_KEY` | no | no |  |
| `CAIRN_LLM_BASE_URL` | no | no |  |
| `CAIRN_LLM_MODEL` | no | no |  |

## FAQ

### What files can Cairn index?

Cairn can index README files, specs, ADRs, documentation folders, PDFs, and Office or web files converted via MarkItDown.

### How does Cairn differ from naive RAG?

Unlike naive RAG that splits structure into context-free chunks, Cairn uses the document's own structure as the index and treats cross-references and entities as first-class objects.

### Can I run Cairn without API keys or model downloads?

Yes, you can use the --fake flag which uses deterministic in-process plugins to run the entire system offline.

### What MCP tools are provided by Cairn?

Cairn provides repo-scoped tools including list_documents, search_documents, repo_context, repo_graph, and repo_impact.
