Entroly — Claude Code MCP server: what it does, how to install
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.
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-mcpWhat Entroly 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.
What it helps with
- 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 for the agent
- 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
How to install Entroly
Platform CLI
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-mcpReplace <…> with your own values
Platform CLI
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-mcpReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
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-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Entroly
How to install Entroly in Claude Code?
Run claude mcp add entroly -- npx -y entroly-mcp in your command line.
What does Entroly do?
It fits prompt evidence into token constraints, creates verifiable selection receipts, and lets agents recover omitted text spans on demand.
Can an agent skip Entroly in MCP mode?
Yes, standalone MCP tools remain optional for models unless you enforce context processing through a verified hook or proxy.
