Skip to content
MCP server

Kompressr

MCP server for uploading, optimizing and sharing files through Kompressr's CDN

Runs locallyStatus and history
Pricing
Free trial
Platforms
CLI, API, macOS
Runs
Locally
Version
2.0.3
Listing updated
3 days ago

About Kompressr

Kompressr is an MCP server for files and documents. It runs locally on your machine and is started by your AI client.

Kompressr's MCP package lets an agent push a generated file into a Kompressr project, wait until it has been processed, and then hand back a delivery link. The README stresses that an accepted upload is not ready to share: the agent should check the status first and only use the delivery URL once it reads as processed.

It exposes upload_asset (from a local path or a URL), wait_for_asset and get_asset_status, generate_private_url for fresh expiring links, list_assets and permanent deletion of explicit asset IDs. If waiting times out, the agent resumes with the saved asset ID rather than uploading again.

It runs over stdio with Node.js 22 or later and needs a Kompressr API key. The README recommends scoped keys for individual agent runtimes, and listing uploads also needs the project UUID. A desktop MCPB bundle is available for clients that support it.

Install

Run in a terminal

claude mcp add kompressr --env KOMPRESSR_API_KEY='<KOMPRESSR_API_KEY>' -- npx -y @kompressr/mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "kompressr": {
      "command": "npx",
      "args": [
        "-y",
        "@kompressr/mcp-server"
      ],
      "env": {
        "KOMPRESSR_API_KEY": "<KOMPRESSR_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "kompressr": {
      "command": "npx",
      "args": [
        "-y",
        "@kompressr/mcp-server"
      ],
      "env": {
        "KOMPRESSR_API_KEY": "<KOMPRESSR_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "kompressr": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@kompressr/mcp-server"
      ],
      "env": {
        "KOMPRESSR_API_KEY": "<KOMPRESSR_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "kompressr": {
      "command": "npx",
      "args": [
        "-y",
        "@kompressr/mcp-server"
      ],
      "env": {
        "KOMPRESSR_API_KEY": "<KOMPRESSR_API_KEY>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "kompressr": {
      "command": "npx",
      "args": [
        "-y",
        "@kompressr/mcp-server"
      ],
      "env": {
        "KOMPRESSR_API_KEY": "<KOMPRESSR_API_KEY>"
      }
    }
  }
}

Configuration

  • KOMPRESSR_API_KEYYour project or scoped API key. Use a scoped key for an individual agent.Required
  • KOMPRESSR_PROJECT_IDProject UUID. Required for listing uploads; other file operations need only the API key.

Tools this server provides (5)

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

upload_asset
Uploads a file from a local path or URL and returns an asset ID.
wait_for_asset
Waits for an uploaded asset to finish processing.
get_asset_status
Checks the processing status of an asset.
generate_private_url
Generates a fresh expiring link for a private asset.
list_assets
Lists a project's uploads with pagination.

What it does

Upload from path or URL
upload_asset takes exactly one file path or file URL and returns an asset ID.
Processing status
wait_for_asset and get_asset_status confirm a file is ready before sharing.
Private expiring links
generate_private_url creates a fresh expiring link for private files.
Scoped keys
Agents can run with a scoped key instead of the master project key.
Upload listing
list_assets pages through a project's uploads when a project ID is set.
Asset deletion
Permanently deletes explicitly named asset IDs.

Good for

  • Giving an image-generating agent a CDN URL for its output
  • Delivering a generated PDF through a private expiring link
  • Letting each customer's agent upload with its own scoped key
  • Checking whether an upload has finished processing

Pricing

Free trial

30-day trial with 100 image uploads; paid plans Starter, Pro, Growth, Enterprise and API (prices not listed here)

Prices change. Check kompressr.com before you buy.

Kompressr FAQ

What does it need to run?

Node.js 22 or later and a Kompressr API key; the project UUID is needed only to list uploads.

What happens if waiting times out?

Resume with the saved asset ID instead of uploading again.

Is there a free trial?

Yes, 30 days with 100 image uploads shared across API, SDKs, MCP and dashboard.

Can it share private files?

Yes, through generate_private_url, which makes a fresh expiring link.

Is Kompressr free?

Kompressr is a paid product with a free trial.

How do I add Kompressr to Claude Code?

Run this command in your terminal: claude mcp add kompressr --env KOMPRESSR_API_KEY='<KOMPRESSR_API_KEY>' -- npx -y @kompressr/mcp-server

What are the best alternatives to Kompressr?

The closest alternatives to Kompressr are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

Alternatives to Kompressr

  1. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  2. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  3. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  4. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents
  5. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media
  6. Agent Yurt

    MCP server

    Back up agent memory, files and dashboards, then recover from a reviewed snapshot

    Not checked yet
    • Remote
    • Free
    • Knowledge and memory