SuperCompress — Claude Code MCP server: what it does, how to install
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.
claude mcp add --transport http supercompress https://api.supercompress.dev/api/mcpWhat SuperCompress 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.
What it helps with
- 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 for the agent
- 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.
How to install SuperCompress
1Platform CLI: remote server
claude mcp add --transport http supercompress https://api.supercompress.dev/api/mcp2Platform CLI
claude mcp add --env SUPERCOMPRESS_API_KEY=<SUPERCOMPRESS_API_KEY> --transport stdio proxy -- npx -y supercompress-proxyReplace <…> with your own values
1Platform CLI: remote server
codex mcp add proxy --url https://api.supercompress.dev/api/mcp2Platform CLI
codex mcp add proxy --env SUPERCOMPRESS_API_KEY=<SUPERCOMPRESS_API_KEY> -- npx -y supercompress-proxyReplace <…> with your own values
Config file
{
"mcpServers": {
"proxy": {
"url": "https://api.supercompress.dev/api/mcp"
}
}
}{
"mcpServers": {
"proxy": {
"command": "npx",
"args": [
"-y",
"supercompress-proxy"
],
"env": {
"SUPERCOMPRESS_API_KEY": "<SUPERCOMPRESS_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"proxy": {
"type": "http",
"url": "https://api.supercompress.dev/api/mcp"
}
}
}{
"servers": {
"proxy": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"supercompress-proxy"
],
"env": {
"SUPERCOMPRESS_API_KEY": "<SUPERCOMPRESS_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http proxy https://api.supercompress.dev/api/mcp2Platform CLI
gemini mcp add -e SUPERCOMPRESS_API_KEY=<SUPERCOMPRESS_API_KEY> proxy npx -y supercompress-proxyReplace <…> 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 SuperCompress
How do I install SuperCompress in Claude Code?
Register the hosted MCP server with claude mcp add --transport http supercompress https://api.supercompress.dev/api/mcp. Restart the agent to load the integration.
What does SuperCompress do?
It compares context with the current question and drops material that does not help answer it. The original question is preserved.
Does setup require Node.js?
The npm installation requires Node.js 18+. For the guided setup, run supercompress setup followed by supercompress doctor.
