# SuperCompress

SuperCompress trims context against the agent’s question before it reaches the model. Use it when a coding task brings in bulky files, logs, or tool output.

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

## What it does

SuperCompress scores supplied context against the current question and keeps passages that matter to the answer. The question itself stays unchanged. Agents access compression through MCP and hooks; available tools include `compress_context` and a check for remaining provider limits.

The npm setup requires Node.js 18+. Run `supercompress setup` to link an account and add MCP and hooks for detected agents, then restart the agent to reload them. Context is sent to the SuperCompress API for processing, so that route matters when working with sensitive material. Provider API keys remain with the agent. An optional local proxy can be enabled with `supercompress setup --proxy`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://api.supercompress.dev/api/mcp`
- Environment variables: `SUPERCOMPRESS_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http supercompress https://api.supercompress.dev/api/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env SUPERCOMPRESS_API_KEY=<SUPERCOMPRESS_API_KEY> --transport stdio proxy -- npx -y supercompress-proxy
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add proxy --url https://api.supercompress.dev/api/mcp
```

2. **Platform CLI**
```bash
codex mcp add proxy --env SUPERCOMPRESS_API_KEY=<SUPERCOMPRESS_API_KEY> -- npx -y supercompress-proxy
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "proxy": {
            "url": "https://api.supercompress.dev/api/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "proxy": {
            "command": "npx",
            "args": [
                "-y",
                "supercompress-proxy"
            ],
            "env": {
                "SUPERCOMPRESS_API_KEY": "<SUPERCOMPRESS_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "proxy": {
            "type": "http",
            "url": "https://api.supercompress.dev/api/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "proxy": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "supercompress-proxy"
            ],
            "env": {
                "SUPERCOMPRESS_API_KEY": "<SUPERCOMPRESS_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http proxy https://api.supercompress.dev/api/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e SUPERCOMPRESS_API_KEY=<SUPERCOMPRESS_API_KEY> proxy npx -y supercompress-proxy
```
Replace <…> with your own values

## When to use it
- trim large files to match a question
- remove irrelevant lines from logs and tool output
- check remaining provider quota
- review account usage and token savings

## Example prompts
- Compress these logs around the question of what caused the error.
- Keep only the tool output that helps answer my question.
- Check the provider quota before taking the next step.

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