furl_compress
Compress large tool outputs, file contents, or logs to reduce context usage, with a retrieval hash to restore the original whenever needed.
Instructions
Compress content to save context window space. Use this on large tool outputs, file contents, search results, or any content you want to shrink before reasoning over it. Pass 'content' with inline text, OR 'file_path' to have the server read and compress a file from disk (ideal for a large trace/log that would overflow context if pasted inline) — exactly one of the two. When it compresses, the original is stored and can be retrieved later via mcp__furl__furl_retrieve: returns compressed text + a hash for retrieval. When Furl decides NOT to compress (a no-op: the content is too small or would not shrink) it returns the original unchanged with hash null and stores NOTHING, so a no-op does not consume a retrieval slot — pass persist=true to store it anyway and get a hash back. Optional 'mode' controls aggressiveness; optional include/exclude patterns limit which lines are compressed.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | Compression aggressiveness (default 'normal' = current behavior). 'lossless_only': only proven-lossless transforms run — nothing is dropped or substituted, so the output carries no retrieval markers (larger, fully reversible). 'aggressive': keep fewer items per crush and accept marginal compressions the default would reject (smaller output; all drops stay CCR-recoverable). | |
| content | No | The inline content to compress. Any text: tool output, JSON, search results, logs, code, etc. Provide EITHER content OR file_path, not both. | |
| persist | No | Store the original even when compression is a no-op (default false). When Furl decides not to compress because the content is too small or would not shrink, it returns the original unchanged and, by default, does NOT store it, so a no-op no longer consumes a retrieval slot. Set true to store it anyway and get a retrieval hash back. | |
| file_path | No | Absolute path to a file the server reads from disk and compresses, so a large artifact (e.g. a multi-MB trace or log) never has to be pasted inline and pay the full context cost first. Confined to the workspace. Provide EITHER file_path OR content, not both. Larger byte ceiling than inline content (override with FURL_MCP_MAX_FILE_BYTES). | |
| exclude_patterns | No | Glob-or-regex patterns. Any content line matching one is PROTECTED — passed through verbatim, never compressed. Applied on top of include_patterns. | |
| include_patterns | No | Glob-or-regex patterns (regex tried first, glob fallback). When set, ONLY content lines matching at least one pattern are eligible for compression; all other lines pass through verbatim. |