# Kompressr

> Kompressr is an MCP server for files and documents. MCP server for uploading, optimizing and sharing files through Kompressr's CDN. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free trial
- **Platforms:** CLI, API, macOS, Windows, Linux
- **Website:** https://kompressr.com/agents
- **Repository:** https://github.com/kompressrcdn/clients/tree/HEAD/mcp-server
- **MCP Registry name:** com.kompressr/kompressr
- **Categories:** files and documents, cloud and infrastructure
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [ASTra](https://ai-powered.com/mcp/astra): ASTra is a freemium MCP server for files and documents.
- [CARTESIAN ECU](https://ai-powered.com/mcp/cartesian-ecu): CARTESIAN ECU is a paid MCP server for files and documents.
- [Invoices](https://ai-powered.com/mcp/invoices): Invoices is a paid MCP server for files and documents.
- [SigPen](https://ai-powered.com/mcp/sigpen): SigPen is a freemium MCP server for files and documents.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [Agent Yurt](https://ai-powered.com/mcp/agent-yurt): Agent Yurt is a free MCP server for knowledge and memory.
- [Proofline](https://ai-powered.com/mcp/proofline): Proofline is a freemium MCP server for developer tools.
- [WhoScribe](https://ai-powered.com/mcp/whoscribe): WhoScribe is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/kompressr
