# contextatlas

Bundles code structure, ADR decisions, git history and test links into a single context payload. Fewer tokens spent hunting through a repo.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 7
- Author: traviswye
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/traviswye/ContextAtlas
- Updated: 2026-10-14
- HTML: https://affpapa.org/en/nevibecode/mcp/contextatlas

## What it does

ContextAtlas is an MCP server that hands the agent a prepared slice of your codebase per symbol. Four signals go in: language-server data (definition, references, types, diagnostics), architectural decisions pulled from ADRs and docs, git history with hot and cold markers, plus test associations. All of it comes back fused in one response instead of a run of greps and file reads.

No ADRs in the repo? You still get structure, git and tests. More signals make the bundle denser. Token savings scale with codebase size, while architectural intent capture does not — a 30-file library can carry constraints the agent should see before touching anything.

Install runs through `npx`, no separate server process to babysit. Cursor and GitHub Copilot need the MCP config written into their settings files by hand. Without ADRs part of the value is missing, which is a reason to write down a couple of decisions you already follow.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add contextatlas -- npx -y contextatlas
```

### Codex

**Platform CLI**
```bash
codex mcp add contextatlas -- npx -y contextatlas
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "contextatlas": {
            "command": "npx",
            "args": [
                "-y",
                "contextatlas"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "contextatlas": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "contextatlas"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add contextatlas npx -y contextatlas
```

## When to use it
- pull context for a symbol in one call instead of repeated greps
- surface architectural constraints before the agent proposes a change
- locate tests that reference a given class or function
- check how often a symbol changed in recent commits
- cut token spend when reading an unfamiliar repository

## Example prompts
- Give me context on `OrderProcessor` before I change it
- Which ADRs touch the billing module?
- Show me which tests cover `charges.ts`

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md