# Entroly

Entroly trims prompt context to fit token limits and logs decisions in verifiable receipts. It lets coding models retrieve omitted code spans using exact source handles.

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

## What it does

Entroly manages prompt context during repository queries. It packs code evidence into bounded payloads. Every selection decision is recorded inside a receipt. When an agent needs omitted context back, the system re-fetches exact source bytes using content handles.

MCP-only setups run as callable tools. Because of that, an agent can skip them. Pruning context reliably demands an upstream proxy or an active prompt hook. You can inspect runtime status with `entroly activation status --json`.

The tool also handles handoffs between different coding agents via `entroly-work resume`. An arriving model reads stored repository evidence directly. It continues the task without re-scanning the whole codebase.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ENTROLY_MCP_PROFILE`, `ENTROLY_MCP_PASSIVE`, `ENTROLY_NO_DOCKER` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env ENTROLY_MCP_PROFILE=<ENTROLY_MCP_PROFILE> --env ENTROLY_MCP_PASSIVE=<ENTROLY_MCP_PASSIVE> --env ENTROLY_NO_DOCKER=<ENTROLY_NO_DOCKER> --transport stdio entroly -- npx -y entroly-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add entroly --env ENTROLY_MCP_PROFILE=<ENTROLY_MCP_PROFILE> --env ENTROLY_MCP_PASSIVE=<ENTROLY_MCP_PASSIVE> --env ENTROLY_NO_DOCKER=<ENTROLY_NO_DOCKER> -- npx -y entroly-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "entroly": {
            "command": "npx",
            "args": [
                "-y",
                "entroly-mcp"
            ],
            "env": {
                "ENTROLY_MCP_PROFILE": "<ENTROLY_MCP_PROFILE>",
                "ENTROLY_MCP_PASSIVE": "<ENTROLY_MCP_PASSIVE>",
                "ENTROLY_NO_DOCKER": "<ENTROLY_NO_DOCKER>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "entroly": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "entroly-mcp"
            ],
            "env": {
                "ENTROLY_MCP_PROFILE": "<ENTROLY_MCP_PROFILE>",
                "ENTROLY_MCP_PASSIVE": "<ENTROLY_MCP_PASSIVE>",
                "ENTROLY_NO_DOCKER": "<ENTROLY_NO_DOCKER>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ENTROLY_MCP_PROFILE=<ENTROLY_MCP_PROFILE> -e ENTROLY_MCP_PASSIVE=<ENTROLY_MCP_PASSIVE> -e ENTROLY_NO_DOCKER=<ENTROLY_NO_DOCKER> entroly npx -y entroly-mcp
```
Replace <…> with your own values

## When to use it
- reduce input token volume when sending repository files to models
- recover omitted file fragments through receipt-backed source handles
- transfer in-progress engineering sessions across models via `entroly-work resume`
- verify what files were retained or skipped before sending a prompt

## Example prompts
- Check if Entroly context control is active using `entroly activation status --json`
- Compress repository context within our token budget and record the selection receipt
- Resume unfinished task state from the earlier agent run using `entroly-work resume`

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