mcp · formatika-app — Claude Code MCP server: what it does, how to install
MCP server to resize, transcode, crop, and compress local images, audio, video, and documents via simple agent prompts.
claude mcp add --env FORMATIKA_API_KEY=<FORMATIKA_API_KEY> --env FORMATIKA_URL=<FORMATIKA_URL> --transport stdio formatika-app-mcp -- npx -y @formatika/mcpWhat mcp 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.
What it helps with
- 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 for the agent
- Optimize every graphic inside
mediaand save copies intobuild - Turn all HEIC captures in this folder into PNG format
- Crop
avatar.pnginto a centered square measuring 256 pixels
How to install mcp
Platform CLI
claude mcp add --env FORMATIKA_API_KEY=<FORMATIKA_API_KEY> --env FORMATIKA_URL=<FORMATIKA_URL> --transport stdio formatika-app-mcp -- npx -y @formatika/mcpReplace <…> with your own values
Platform CLI
codex mcp add formatika-app-mcp --env FORMATIKA_API_KEY=<FORMATIKA_API_KEY> --env FORMATIKA_URL=<FORMATIKA_URL> -- npx -y @formatika/mcpReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
gemini mcp add -e FORMATIKA_API_KEY=<FORMATIKA_API_KEY> -e FORMATIKA_URL=<FORMATIKA_URL> formatika-app-mcp npx -y @formatika/mcpReplace <…> 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 mcp
How to install mcp in Claude Code?
Run claude mcp add mcp -e FORMATIKA_API_KEY=<FORMATIKA_API_KEY> -- npx -y @formatika/mcp in your command line. You can omit the environment flag if you rely on the starter daily quota.
What does this server do?
It gives your agent commands to resize, rotate, optimize, transcode, and trim local media files without writing ad-hoc conversion scripts.
Are processed files permanently stored on remote servers?
No, data leaves your machine only during active processing. The remote service purges uploads within two hours without an account, or within twenty-four hours when authenticated.
Similar MCP servers
All MCP servers for Agent setup: memory, context, orchestration →mcp by other authors comes first.
