Account

Tinify MCP

Let your agent compress images.

@tinify-dev/mcp gives Claude, Cursor, Codex, and any MCP client five image tools backed by the Tinify API. 500 free operations per month, no card.

Create an API key

Install

Pick your client.

Every path runs the same server over stdio with npx. You need Node.js 20 or newer and an API key from the dashboard - replace tnf_live_... with yours.

Claude Code

One command in any terminal.

Terminal
claude mcp add tinify -e TINIFY_API_KEY=tnf_live_... -- npx -y @tinify-dev/mcp

Claude Code plugin

The plugin bundles the server with a marketplace entry. Run both commands inside Claude Code.

Claude Code
/plugin marketplace add Stianlars1/tinify-claude-plugin
/plugin install tinify@tinify

Claude Desktop

Add to claude_desktop_config.json (Settings, then Developer, then Edit Config).

JSONclaude_desktop_config.json
{
  "mcpServers": {
    "tinify": {
      "command": "npx",
      "args": ["-y", "@tinify-dev/mcp"],
      "env": { "TINIFY_API_KEY": "tnf_live_..." }
    }
  }
}

Cursor

The install link opens Cursor and pre-fills the server. Swap YOUR_API_KEY for a real key before saving.

Add to Cursor

If the link does not open, add this under mcpServers in .cursor/mcp.json:

JSONtinify
{
  "command": "npx",
  "args": ["-y", "@tinify-dev/mcp"],
  "env": { "TINIFY_API_KEY": "YOUR_API_KEY" }
}

VS Code

One command; set TINIFY_API_KEY when VS Code prompts for the environment.

Terminal
code --add-mcp '{"name":"tinify","command":"npx","args":["-y","@tinify-dev/mcp"]}'

Codex CLI

Either one command, or the equivalent block in ~/.codex/config.toml.

Terminal
codex mcp add tinify --env TINIFY_API_KEY=... -- npx -y @tinify-dev/mcp
TOMLconfig.toml
[mcp_servers.tinify]
command = "npx"
args = ["-y", "@tinify-dev/mcp"]

[mcp_servers.tinify.env]
TINIFY_API_KEY = "tnf_live_..."

Five tools

Small surface, honest numbers.

Every image tool writes a new file and never overwrites the source. Results return raw byte counts so the agent can do arithmetic instead of parsing prose.

compress_image

Compress PNG, JPEG, WebP, or AVIF. Returns optimized: false instead of a larger file.

resize_image

Resize by width, height, or scale. Size increases are reported plainly.

crop_image

Crop with explicit pixel coordinates and dimensions.

convert_image

Convert between AVIF, WebP, JPEG, and PNG. Conversion can grow a file; the numbers say so.

get_usage

Read plan, billing period, and operations used and remaining.

Create an API keyRead the API docs@tinify-dev/mcp on npmSource on GitHub