SuperCompress

Official registry Developer tools

Compress coding-agent context ~64%. Hosted Neural Keep MCP for Cursor/Claude/Codex.

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code
claude mcp add --transport http supercompress 'https://api.supercompress.dev/api/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "supercompress": {
            "type": "http",
            "url": "https://api.supercompress.dev/api/mcp"
        }
    }
}
NPM package supercompress-proxy
Claude Code
claude mcp add supercompress -e 'SUPERCOMPRESS_API_KEY=<your supercompress_api_key>' -- npx -y supercompress-proxy@0.5.38 supercompress-mcp
JSON configuration (Claude Desktop, Cursor, VS Code)
{
    "mcpServers": {
        "supercompress": {
            "command": "npx",
            "args": [
                "-y",
                "supercompress-proxy@0.5.38",
                "supercompress-mcp"
            ],
            "env": {
                "SUPERCOMPRESS_API_KEY": "<your supercompress_api_key>"
            }
        }
    }
}

Environment variables

  • SUPERCOMPRESS_API_KEY secret Optional API key (sc_…). Prefer OAuth / device-link via `supercompress setup` if unset.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. SuperCompress v2
  2. Why it exists
  3. Product
  4. Benchmarks & stats
  5. Try it
  6. How it compares

SuperCompress v2

Query-aware context compression for AI applications and coding agents.

Cut coding-agent context ~64% in our B5 benchmark.

~400M Neural Keep on the hosted API · coding-agent plugin via MCP

Open weights (MIT) on Hugging Face

64.1% mean context cut on B5 (24 coding-agent cases) · 24/24 evidence passes · up to 96.6% @ ≥99% retention

(B5 coding-agent suite · evidence containment metric — not downstream LLM completion)

Get API key · Arena · Install · Benchmarks · Docs

vs Headroom · vs RTK · vs LLMLingua


Why it exists

Every LLM call ships a pile of context: RAG chunks, chat history, tool dumps, logs, JSON. Most of it is irrelevant to the current question — but the model still reads it, and you still pay for it.

Usual “fix”What actually happens
TruncateDeletes the middle. The answer is often in the middle.
SummarizeRewrites evidence. IDs, stack traces, and exact errors get soft.
HopeShip the full dump. Watch the bill climb.

SuperCompress v2 compresses context against the query. It keeps answer-critical lines in their original wording and drops the rest — on our coding-agent benchmark (B5), 64.1% mean context reduction with 24/24 evidence-retention passes.


Product

SuperCompress is a compression layer in front of inference:

  1. Takes a long context + the current query
  2. Segments and scores blocks by relevance to that query
  3. Keeps entities, errors, definitions, nearby dependencies
  4. Returns a smaller prompt + token stats

The query is never compressed — only the surrounding context.

Two paths
Neural v2 (recommended)Compiler (fast/local)
Engine~400M query-aware cross-encoderLightweight local policy
RuntimeHosted Fly CPU (Neural Keep)Local CPU · millisecond-class
Best forHighest-quality keep on agent dumpsLocal preprocessing / speed
BenchmarksLaunch / B5Legacy section
Two products
Coding-agent pluginAPI / Python
ForCursor, Claude Code, Codex, and 40+ agent harnessesApps, RAG, agents, backends
Installnpm i -g supercompress-proxy && npx supercompress setuppip install supercompress
What you getMCP compress_context on big dumpsCompress before every model call
LoginKeep your normal agent loginAPI key from the dashboard

Docs: coding agents (first 5 minutes checklist) · API quickstart

Repo map
PathWhat
packages/proxyCoding-agent plugin (npm)
api/Hosted API + billing
web/Site + docs HTML
supercompress/Python package
docs/REPO_LAYOUT.mdWhat belongs in OSS vs private

Private marketing, outreach, and model training stay out of this repo (see .gitignore + docs/REPO_LAYOUT.md).


Benchmarks & stats

We measure whether required evidence survives (containment), not downstream LLM completion.

Neural v2 launch (hosted ~400M) — B5 coding-agent suite
MetricResult
Mean context cut64.1%
Evidence passes24 / 24
Tokens16,647 → 5,148
Max cut @ ≥99% retention96.6%
B5 latency p50~5.8 s (hosted Neural Keep on Fly CPU)
Public cases (full suite)390
Downstream LLM evalNot yet run

Aggregate mean cut across all 390 cases is ~3.6% — the engine often refuses to over-cut dense needle/QA slices. The 64.1% figure is the coding-agent suite where dumps are noisy.

Raw JSON: launch-benchmark.json · writeup: benchmarks

Legacy compiler (separate product)

CPU / millisecond-class local path. Older held-out compiler numbers (≈58–66% cut, 99.4% gold containment) live under Legacy/compiler on /benchmarks. Do not mix with Neural v2.


Try it

npm install -g supercompress-proxy
npx supercompress setup

Links your account, detects agents, installs MCP. Docs: coding agents

Python / HTTP
pip install supercompress
export SUPERCOMPRESS_API_KEY=sc_live_YOUR_KEY
from supercompress.client import SuperCompress

sc = SuperCompress()
result = sc.compress(
    context=long_context,
    query="What failed and how do we fix it?",
)
print(f"{result.original_tokens} → {result.kept_tokens} tokens")
print(result.compressed_text)
curl -X POST https://www.supercompress.dev/api/v1/compress \
  -H "X-API-Key: $SUPERCOMPRESS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"context":"...","query":"What failed?"}'

Or paste a dump into the Arena — no integration required.


How it compares

TruncateSummarizeSuperCompress
Cuts tokens✓✓✓
Uses the query✗weak✓
Keeps original evidencesometimes✗✓
Auditable kept linespartial✗✓

More: vs truncation · vs summarization · vs alternatives


supercompress.dev · MIT License · Sponsor · built by Arjun Shah

Frequently asked questions

What is SuperCompress?

Compress coding-agent context ~64%. Hosted Neural Keep MCP for Cursor/Claude/Codex.

How do I install SuperCompress?

It runs as a remote server. In Claude Code: claude mcp add --transport http supercompress 'https://api.supercompress.dev/api/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does SuperCompress need an API key?

Yes. It expects SUPERCOMPRESS_API_KEY, which you set in its configuration.

Is SuperCompress open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains SuperCompress?

It is published by Supercompress. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.