# mcp

MCP server to resize, transcode, crop, and compress local images, audio, video, and documents via simple agent prompts.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: formatika-app
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/formatika-app/mcp
- Updated: 2026-08-13
- HTML: https://affpapa.org/en/nevibecode/mcp/formatika-app-mcp

## What it does

This package exposes tools from formatika directly to your development agent. It pulls its tool registry upon startup, instantly granting access to file operations across images, sound files, video clips, subtitles, spreadsheets, and PDF documents.

Every tool expects target paths and an optional `outputDir` parameter. Generated files land alongside originals unless specified, and the server preserves existing files by appending incremental digits to duplicate names.

Occasional edits run under a free daily quota without an account. Heavy workloads require an API token set via `FORMATIKA_API_KEY`. On Windows workstations, Claude Desktop cannot run `npx` without a shell, requiring a `cmd /c` wrapper inside the configuration.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `FORMATIKA_API_KEY`, `FORMATIKA_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env FORMATIKA_API_KEY=<FORMATIKA_API_KEY> --env FORMATIKA_URL=<FORMATIKA_URL> --transport stdio formatika-app-mcp -- npx -y @formatika/mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add formatika-app-mcp --env FORMATIKA_API_KEY=<FORMATIKA_API_KEY> --env FORMATIKA_URL=<FORMATIKA_URL> -- npx -y @formatika/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "formatika-app-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@formatika/mcp"
            ],
            "env": {
                "FORMATIKA_API_KEY": "<FORMATIKA_API_KEY>",
                "FORMATIKA_URL": "<FORMATIKA_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "formatika-app-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@formatika/mcp"
            ],
            "env": {
                "FORMATIKA_API_KEY": "<FORMATIKA_API_KEY>",
                "FORMATIKA_URL": "<FORMATIKA_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e FORMATIKA_API_KEY=<FORMATIKA_API_KEY> -e FORMATIKA_URL=<FORMATIKA_URL> formatika-app-mcp npx -y @formatika/mcp
```
Replace <…> with your own values

## When to use it
- transcode batches of HEIC images into PNG format
- compress bulky graphics inside a project folder before deployment
- crop a portrait into a square profile image
- transform audio tracks or spreadsheets directly from the coding terminal

## Example prompts
- Optimize every graphic inside `media` and save copies into `build`
- Turn all HEIC captures in this folder into PNG format
- Crop `avatar.png` into a centered square measuring 256 pixels

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 392262
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33989
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81163
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119231
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47577
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902

## Other versions with the same name
- [mcp · kubeshark](https://affpapa.org/en/nevibecode/mcp/kubeshark-mcp.md) — ★ 12110
- [mcp · butterbase-ai](https://affpapa.org/en/nevibecode/mcp/butterbase-ai-mcp.md) — ★ 3031
- [mcp · medplum](https://affpapa.org/en/nevibecode/mcp/mcp.md) — ★ 2766
- [mcp · sceneview](https://affpapa.org/en/nevibecode/mcp/sceneview-mcp.md) — ★ 1349
- [mcp · buoy-gg](https://affpapa.org/en/nevibecode/mcp/buoy-gg-mcp.md) — ★ 691

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md