Skip to content
MCP server

SuperCompress

MCP and proxy that compresses coding-agent context before it reaches the model

Install
Pricing
Freemium
Platforms
CLI, API
Runs
Locally or Remotely
Version
0.5.38
Listing updated
1 day ago

About SuperCompress

SuperCompress is a freemium MCP server for ai models and llm tooling. It can run locally on your machine or as a hosted remote server.

SuperCompress sits between an agent and the model and scores bulky context, such as logs, diffs, tool traces and pasted files, against the current question. Lines that carry the needed evidence are kept in their original wording and the rest is dropped, rather than rewritten as a summary. The user's own question is never altered.

The vendor reports a 64.1% mean context cut on its coding-agent benchmark, 16,647 tokens down to 5,148, with required evidence kept in 24 of 24 cases, and notes this measures evidence containment, not downstream answer quality or a total bill reduction. The npm package supercompress-proxy installs MCP and hooks across 40+ coding-agent harnesses, including Cursor, Claude Code, Codex and Windsurf, with a browser sign-in. Four MCP tools handle compression, account linking, usage and rate-limit runway.

There is also an API and SDK for chatbots, RAG and support agents. An optional local proxy rewrites an OpenAI-compatible base URL.

Install

Run in a terminal

claude mcp add --transport http supercompress https://api.supercompress.dev/api/mcp

Add to Settings → Connectors → Add custom connector

https://api.supercompress.dev/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "supercompress": {
      "url": "https://api.supercompress.dev/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "supercompress": {
      "type": "http",
      "url": "https://api.supercompress.dev/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "supercompress": {
      "serverUrl": "https://api.supercompress.dev/api/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "supercompress": {
      "type": "http",
      "url": "https://api.supercompress.dev/api/mcp"
    }
  }
}

Configuration

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

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

compress_context
Compresses bulky context for a query
connect_account
Links the install to your dashboard
usage_summary
Shows savings for the connected account
runway_check
Checks provider rate-limit runway locally

What it does

Query-aware compression
Scores context against the current question and drops the rest.
Original wording kept
Keeps evidence lines verbatim instead of summarising.
40+ agent harnesses
One setup command adds MCP and hooks to supported agents.
Usage reporting
Shows plan, quota and savings.
Rate-limit runway
Checks provider rate-limit windows locally.
Optional local proxy
Can rewrite an OpenAI-compatible base URL to localhost.

Good for

  • Shrink a huge log or diff before an agent reads it
  • Cut input tokens in a long coding session
  • Check how much of a rate-limit window remains
  • Compress retrieved documents before a model call

Pricing

Freemium

1M free tokens/month, then $0.10 per 1M tokens

Prices change. Check supercompress.dev before you buy.

SuperCompress FAQ

What does it cost?

The site lists 1M free tokens a month, then $0.10 per 1M.

Does it keep the answer-critical lines?

The vendor reports required evidence held in 24 of 24 benchmark cases, measured as evidence containment.

How do I install it?

npm install -g supercompress-proxy, then run supercompress setup.

Does it need an API key?

Not necessarily; the setup flow uses a secure browser sign-in and an API key is optional.

Is SuperCompress free?

SuperCompress has a free plan, with paid plans for more usage or features.

How do I add SuperCompress to Claude Code?

Run this command in your terminal: claude mcp add --transport http supercompress https://api.supercompress.dev/api/mcp

What are the best alternatives to SuperCompress?

The closest alternatives to SuperCompress are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to SuperCompress

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools