Account

Tinify MCP

Let your agent compress images.

Tinify gives ChatGPT, Claude, Cursor, Codex, and other MCP clients five image tools backed by the same API. 500 free operations per month, no card.

Create an API key

Connect or install

Pick your client.

ChatGPT uses the hosted OAuth server. Desktop and CLI clients run the same toolset locally over stdio with npx and need Node.js 20 or newer. Both paths use an API key from the dashboard.

ChatGPT

Enable Developer mode in ChatGPT under Settings, Security and login. Open ChatGPT Plugins, add https://api.tinify.dev/mcp, and complete Connect Tinify with your API key. Attach a PNG, JPEG, WebP, or AVIF image and try:

Prompt
Use Tinify to compress this attached image for the web. Show the original size, result size, and percentage saved.

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.

Local clients write a new file and never overwrite the source. Hosted clients receive a temporary result link instead. Both 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